GitHubFeedback FormAPI Reference - Beta

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

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
post
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": "+905350000000",
    "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

Last updated