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.

Kendinize ait bir alt üye oluşturup bu alt üyeyi ürünlere tanımlayarak,
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

Non3D ödeme başarılı yanıtı.

statusstring · enumOptional

İşlem sonucu (başarı/başarısız).

Example: successPossible values:

localestring · enumOptional

Yanıt dili.

Example: trPossible values:

systemTimeintegerOptional

İşlem zamanı (epoch ms).

Example: 1756197410420

conversationIdstringOptional

İstek/yanıt eşleştirme ID’si.

Example: 123456789

pricedecimalOptional

Talep edilen ana tutar (sepet).

Example: 100

paidPricedecimalOptional

Çekilen toplam tutar (POS üzerinden).

Example: 100

installmentintegerOptional

Taksit sayısı.

Example: 1

paymentIdstringOptional

iyzico ödeme numarası.

Example: 25223114

fraudStatusinteger · enumOptional

Fraud filtrelerine göre ödeme durumu. Eğer ödemenin fraud risk skoru düşük ise ödemeye anında onay verilir, eğer fraud risk skoru yüksek ise ödeme işlemi reddedilir. Üye işyeri sadece 1 olan işlemlerde ürünü kargoya vermelidir, 0 olan işlemler için bilgilendirme beklemelidir.

1: Onaylandı
0: İncelemede
-1: Reddedildi

Example: 1Possible values:

merchantCommissionRatedecimalOptional

İş yeri komisyon oranı.

Example: 0

merchantCommissionRateAmountdecimalOptional

İş yeri komisyon tutarı.

Example: 0

iyziCommissionRateAmountdecimalOptional

iyzico komisyon oran tutarı.

Example: 3.49

iyziCommissionFeedecimalOptional

iyzico sabit ücret.

Example: 0.25

cardTypestringOptional

Kart türü (CREDIT_CARD/DEBIT_CARD vb.).

Example: CREDIT_CARD

cardAssociationstringOptional

Kart şeması (VISA/MASTER_CARD vb.).

Example: MASTER_CARD

cardFamilystringOptional

Kart ailesi/markası.

Example: Axess

binNumberstringOptional

BIN numarası (ilk 6 hane).

Example: 552608

lastFourDigitsstringOptional

Kartın son 4 hanesi.

Example: 0006

basketIdstringOptional

Sepet ID.

Example: basketId

currencystringOptional

Para birimi.

Example: TRY

authCodestringOptional

Banka provizyon kodu.

Example: 038911

phasestringOptional

İşlem fazı (AUTH/PREAUTH vb.).

Example: AUTH

hostReferencestringOptional

Host referansı.

Example: mock00007iyzihostrfn

signaturestringOptional

Yanıt imzası (doğrulama için).

Example: 8ab2a1...fffe109e

400

Hata

application/json

post

/payment/auth

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"
}