Pazaryeri Ödemesi

Pazaryeri türünde ödeme almanın birden fazla yolu bulunmaktadır. 4 farklı türde ödeme alabilmektedir. Bu ödeme türleri aşağıda belirtilmiştir.

Ödeme Türü Belirleme

Non-3DS

3DS

Ödeme Formu (CheckoutForm)

iyzico ile Öde (PWI)

Pazaryeri sahibi olarak satış yapmak istiyorsanız iki adet yöntem bulunmaktadır.

1. Kendinize ait bir alt üye oluşturup bu alt üyeyi ürünlere tanımlayarak,

2. Alt üye olmadan satış yapmak istiyorsanız eğer paymentGroup parametresini LISTING göndererek yapabilirsiniz. ( Bu yapıyı uygularsanız submerchantkey parametresi kullanılamamaktadır. )

Dört adet ödeme türünden birine karar verdikten sonra yapmanız gereken ekstra 2 parametre eklemek olacaktır. Bunlar subMerchantKey ve subMerchantPrice parametreleridir. Bu parametreleri ödeme isteğinde bulunan her ürüne tanımlamanız gerekmektedir.

Parametre İsmi	Tip	Zorunluluk	Açıklama
subMerchantKey	string	evet	Alt üye işyeri oluşturma sorgusundan dönen değer.
subMerchantPrice	string	evet	Alt üye işyerine IBAN adresine gönderilmesi istenen tutar.

Pazaryeri Ödemesi

post

Örnek olarak NON3D yöntemi paylaşılmıştır. Tüm ödeme yöntemlerinde pazaryeri için her bir ödeme kırılımında alt üye alanlarını eklenmelidir.

Header parameters

AuthorizationstringRequired

Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.

Example: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=

Content-Typestring · enumRequired

İstek gövdesi formatı.

Example: application/jsonPossible values:

Body

application/json

Non3D ödeme isteği. Pazaryeri modelinde her bir ödeme kırılımında alt üye bilgilerinin gönderilemsi gereklidir.

localestring · enumOptional

Yanıt dili.

Example: trPossible values:

conversationIdstringOptional

İstek/yanıt eşleştirmesi için gönderilen değer; yanıtta aynen geri döner.

Example: 123456789

pricedecimalRequired

Ödeme sepet tutarı. Kırılım (basketItems) tutarları toplamı price’a eşit olmalıdır.

Example: 100

paidPricedecimalRequired

İndirim/vade farkı sonrası POS’tan geçecek nihai tutar; price’tan küçük, büyük veya eşit olabilir.

Example: 100

currencystring · enumOptional

Ödeme para birimi (varsayılan TRY).

Example: TRY.Possible values:

installmentinteger · enumOptional

Taksit sayısı. Varsayılan; 1

Example: 1Possible values:

paymentChannelstring · enumOptional

Ödeme kanalı. Varsayılan; "WEB"

Example: WEB.Possible values:

basketIdstringOptional

Üye işyeri tarafındaki sepet/sipariş kimliği (sipariş numarası veya anlamlı başka bir değer olabilir).

Example: basketId

paymentGroupstring · enumOptional

Ödeme grubu.

Example: PRODUCT. Varsayılan; "PRODUCT"Possible values:

Responses

200

Başarılı

application/json

400

Hata

application/json

post

/payment/auth

HTTPcURL

POST https://api.iyzipay.com/payment/auth
Authorization: {{authorization}}
Content-Type: application/json

{
  "locale": "tr",
  "conversationId": "123456789",
  "price": 100.0,
  "paidPrice": 100.0,
  "currency": "TRY",
  "installment": 1,
  "paymentChannel": "WEB",
  "basketId": "basketId",
  "paymentGroup": "PRODUCT",
  "paymentCard": {
    "cardHolderName": "John Doe",
    "cardNumber": "5526080000000006",
    "expireYear": "2025",
    "expireMonth": "12",
    "cvc": "123",
    "registerCard": 0
  },
  "buyer": {
    "id": "BY789",
    "name": "John",
    "surname": "Doe",
    "identityNumber": "74300864791",
    "email": "[email protected]",
    "gsmNumber": "[phone]",
    "registrationDate": "2013-04-21 15:12:09",
    "lastLoginDate": "2015-10-05 12:43:35",
    "registrationAddress": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
    "city": "Istanbul",
    "country": "Turkey",
    "zipCode": "34732",
    "ip": "85.34.78.112"
  },
  "shippingAddress": {
    "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
    "zipCode": "34742",
    "contactName": "Jane Doe",
    "city": "Istanbul",
    "country": "Turkey"
  },
  "billingAddress": {
    "address": "Altunizade Mah. İnci Çıkmazı Sokak No: 3 İç Kapı No: 10 Üsküdar İstanbul",
    "contactName": "Jane Doe",
    "city": "Istanbul",
    "country": "Turkey"
  },
  "basketItems": [
    {
      "id": "BI103",
      "name": "Usb",
      "price": "100.0",
      "category1": "Electronics",
      "category2": "Usb / Cable",
      "itemType": "PHYSICAL",
      "subMerchantKey": "n621Bd1zi4vpW/uVkMc8vCnwTPk=",
      "subMerchantPrice": "94.2",
      "withholdingTax": "0.8"
    }
  ]
}

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1756197410420,
  "conversationId": "123456789",
  "price": 100,
  "paidPrice": 100,
  "installment": 1,
  "paymentId": "25223114",
  "fraudStatus": 1,
  "merchantCommissionRate": 0,
  "merchantCommissionRateAmount": 0,
  "iyziCommissionRateAmount": 3.49,
  "iyziCommissionFee": 0.25,
  "cardType": "CREDIT_CARD",
  "cardAssociation": "MASTER_CARD",
  "cardFamily": "Axess",
  "binNumber": "552608",
  "lastFourDigits": "0006",
  "basketId": "basketId",
  "currency": "TRY",
  "itemTransactions": [
    {
      "itemId": "BI103",
      "paymentTransactionId": "27212232",
      "transactionStatus": 1,
      "price": 100,
      "paidPrice": 100,
      "merchantCommissionRate": 0,
      "merchantCommissionRateAmount": 0,
      "iyziCommissionRateAmount": 3.49,
      "iyziCommissionFee": 0.25,
      "blockageRate": 0,
      "blockageRateAmountMerchant": 0,
      "blockageRateAmountSubMerchant": 0,
      "withholdingTax": 0.8,
      "blockageResolvedDate": "2025-09-02 11:36:50",
      "subMerchantKey": "n621Bd1zi4vpW/uVkMc8vCnwTPk=",
      "externalSubMerchantId": "ExternalId31",
      "subMerchantPrice": 94.2,
      "subMerchantPayoutRate": 94.2,
      "subMerchantPayoutAmount": 94.2,
      "merchantPayoutAmount": 2.06,
      "convertedPayout": {
        "paidPrice": 100,
        "iyziCommissionRateAmount": 3.49,
        "iyziCommissionFee": 0.25,
        "blockageRateAmountMerchant": 0,
        "blockageRateAmountSubMerchant": 0,
        "subMerchantPayoutAmount": 94.2,
        "merchantPayoutAmount": 2.06,
        "iyziConversionRate": 0,
        "iyziConversionRateAmount": 0,
        "currency": "TRY"
      }
    }
  ],
  "authCode": "038911",
  "phase": "AUTH",
  "hostReference": "mock00007iyzihostrfn",
  "signature": "8ab2a15666c4687a47d2f3144034d732e5dae1d3b3a3a07b35823493fffe109e"
}

Örnek Kodlar

PHP

Java

.NET

Node.Js

Python