Skip to main content
CreativeCode

Turkey payment integration

PayTR+Özel Yazılım

Easily add card + installment + 3D Secure + payment link to your e-commerce via PayTR API.

Quick answer

PayTR integration connects one of Turkey's most common payment gateways to your e-commerce or custom software. Supports card, 3D Secure, installment, bank transfer, payment link, and iframe mode. Commission rates are slightly lower than iyzico, with comparable technical documentation.

Setup cost

$350-1.7K

Monthly

PayTR fee 1.5-2.99% + transaction fee (volume-based)

Duration

1-2 weeks

Who is this for

→WooCommerce / OpenCart / Magento payment

→Card + installment in custom software

→Payment link (WhatsApp invoice link)

→Subscription / recurring payment

→B2B invoice payment system

Data flow

Customer → Checkout → PayTR iFrame or redirect → 3D Secure (bank) → PayTR → Approval callback → App confirms order.

Setup steps

  1. 01

    PayTR application + approval

    Register + KYC documents at paytr.com. Approval 3-7 business days.

  2. 02

    API credentials

    Merchant ID + Merchant Key + Merchant Salt from dashboard.

  3. 03

    iFrame mode integration

    POST /odeme/api/v1 to generate token → add to iFrame src. Fastest route.

  4. 04

    3D Secure + installment config

    Mandatory 3D Secure? How many installment months? Per-bank settings.

  5. 05

    Callback endpoint

    POST callback URL receives PayTR success/failure. HMAC signature verification is mandatory.

  6. 06

    Test + go-live

    30+ test-card scenarios + production.

Common pitfalls

  • iFrame CORS misconfiguration → payment window won't open
  • Wrong HMAC signature → 'Invalid request' error
  • Installment rates are per-bank — config is complex
  • Refund API documentation is thin

Frequently asked questions

PayTR or iyzico?

PayTR commission is slightly lower; iyzico has higher user recognition + slightly smoother UX. Both are technically comparable. Volume-based price negotiation is recommended.

What is payment link?

A payment link is generated via dashboard or API and sent to the customer via WhatsApp/email. Accepts payment without a physical POS. Ideal for SMBs.

Is there a WooCommerce plugin?

Yes — PayTR has an official WooCommerce plugin, free, 15-minute install. For custom frameworks, API integration takes 1-2 weeks.

Get a quote for PayTR + Özel Yazılım integration

Fixed-scope written proposal after a 30-minute discovery call.

Start a discovery call