API - NON3D

Create Non3D Payment

post

3D Secure olmadan ödeme başlatır.

Header parameters

AuthorizationstringRequired

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

Example: IYZWSv2 aXBzaWduYXR1cmU...

Content-TypestringRequired

Content-Type değeri.

Example: application/json

Body

conversationIdstringOptional

İstek/yanıt eşleştirmesi için benzersiz ID.

Example: conversationId

localestring · enumOptional

Dil kodu. Alabileceği değerler; tr, en. Default; tr

Example: trPossible values:

paidPricedecimalRequired

Kullanıcıdan tahsil edilecek toplam tutar.

Example: 1

pricedecimalRequired

Sepet toplam tutarı.

Example: 1

paymentGroupstring · enumOptional

Ödeme grubu. Default; PRODUCT.

Example: PRODUCTPossible values:

currencystring · enumRequired

Para birimi. Default; TRY.

Example: TRYPossible values:

installmentinteger · enumOptional

Taksit sayısı. Gönderilmezse tek çekim (1) olarak işlem sağlanılabilir.

Possible values:

basketIdstringOptional

Sepet ID’si.

Example: B67832

paymentChannelstring · enumOptional

Ödeme kanalı.

Example: WEBPossible values:

paymentSourcestringOptional

Bu alan, partner firmalar tarafından iletilen ödeme kaynağı bilgisidir. Eğer bir altyapı sağlayıcısıysanız ve iyzico ile entegrasyon/iş birliğiniz bulunuyorsa bu parametreyi gönderebilirsiniz.

Example: Shopify

Responses

200

Başarılı yanıt

application/json

statusstring · enumOptional

Yapılan isteğin sonucunu bildirir.

Example: successPossible values:

localestringOptional

Yanıt dili (tr/en).

Example: tr

systemTimeintegerOptional

İşlem zamanı (epoch ms).

Example: 1755198001941

conversationIdstringOptional

İstek ile eşleşen ID.

Example: conversationId

pricedecimalOptional

Sepet toplam tutarı.

Example: 1

paidPricedecimalOptional

Tahsil edilen toplam tutar.

Example: 1

installmentintegerOptional

Taksit sayısı.

Example: 1

paymentIdstringOptional

Ödeme ID’si.

Example: 25149157

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

Üye işyerinin uyguladığı vade/komisyon oranı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon oranı %10’dur. Bilgi amaçlıdır.

Example: 0

merchantCommissionRateAmountdecimalOptional

Üye işyerinin uyguladığı vade/komisyon tutarı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon tutarı 10’dur. Bilgi amaçlıdır.

Example: 0

iyziCommissionRateAmountdecimalOptional

Ödemeye ait iyzico işlem komisyon tutarı.

Example: 0.2094

iyziCommissionFeedecimalOptional

Ödemeye ait iyzico işlem ücreti.

Example: 0.25

cardTypestring · enumOptional

Kart tipi.

Example: CREDIT_CARDPossible values:

cardAssociationstring · enumOptional

Kart kuruluşu.

Example: MASTER_CARDPossible values:

cardFamilystring · enumOptional

Kart ailesi.

Example: AxessPossible values:

binNumberstringOptional

BIN (ilk 8 hane).

Example: 552608

lastFourDigitsstringOptional

Kartın son 4 hanesi.

Example: 0006

basketIdstringOptional

Sepet ID.

Example: basketId

currencystring · enumOptional

Para birimi.

Example: TRYPossible values:

authCodestringOptional

Bankadan dönen authCode değeri.

Example: 214525

phasestringOptional

Ödeme Fazı.

Example: AUTH

hostReferencestringOptional

Ödemeye ilişkin banka tarafından verilen hostReference değeri.

Example: mock00001iyzihostrfn

signaturestringOptional

İmza doğrulaması için kullanılabilecek signature değeri.

Example: 5f510cd92b4b9c50a39b617cda228f4159f290860a4c20a965c55b119c9e9052

400

Hatalı istek / doğrulama hatası

application/json

post

/payment/auth

HTTP

POST https://api.iyzipay.com/payment/auth
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "conversationId":"conversationId",
  "locale":"tr",
  "paidPrice":1.0,
  "price":1.0,
  "paymentGroup":"PRODUCT",
  "currency":"TRY",
  "basketId":"B67832",
  "paymentChannel":"WEB",
  "installment": 1,
  "paymentCard":{
    "cardHolderName":"John Doe",
    "cardNumber":"5528790000000008",
    "expireMonth":"12",
    "expireYear":"2030",
    "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":"Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
    "city":"Istanbul",
    "country":"Turkey",
    "zipCode":"34732",
    "ip":"85.34.78.112"
  },
  "shippingAddress":{
    "address":"Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
    "zipCode":"34742",
    "contactName":"Jane Doe",
    "city":"Istanbul",
    "country":"Turkey"
  },
  "billingAddress":{
    "address":"Nidakule Göztepe, Merdivenköy Mah. Bora Sok. No:1",
    "zipCode":"34742",
    "contactName":"Jane Doe",
    "city":"Istanbul",
    "country":"Turkey"
  },
  "basketItems":[
    {
      "id":"BI101",
      "price":1.0,
      "name":"Binocular",
      "category1":"Collectibles",
      "category2":"Accessories",
      "itemType":"PHYSICAL"
    }
  ],
  "paymentSource": "Test"
}

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1700000000000,
  "conversationId": "conversationId",
  "price": 1,
  "paidPrice": 1,
  "installment": 1,
  "paymentId": "25147713",
  "fraudStatus": 1,
  "merchantCommissionRate": "0E-8",
  "merchantCommissionRateAmount": "0E-8",
  "iyziCommissionRateAmount": 0.0349,
  "iyziCommissionFee": 0.25,
  "cardType": "CREDIT_CARD",
  "cardAssociation": "MASTER_CARD",
  "cardFamily": "Axess",
  "binNumber": "552879",
  "lastFourDigits": "0008",
  "basketId": "B67832",
  "currency": "TRY",
  "itemTransactions": [
    {
      "itemId": "BI101",
      "paymentTransactionId": "27137212",
      "transactionStatus": 2,
      "price": 0.3,
      "paidPrice": 0.3,
      "merchantCommissionRate": "0E-8",
      "merchantCommissionRateAmount": "0E-8",
      "iyziCommissionRateAmount": 0.01047,
      "iyziCommissionFee": 0.075,
      "blockageRate": "0E-8",
      "blockageRateAmountMerchant": "0E-8",
      "blockageRateAmountSubMerchant": "0E-8",
      "blockageResolvedDate": "2025-08-22 00:00:00",
      "subMerchantPrice": 0,
      "subMerchantPayoutRate": "0E-8",
      "subMerchantPayoutAmount": 0,
      "merchantPayoutAmount": 0.21453,
      "convertedPayout": {
        "paidPrice": 0.3,
        "iyziCommissionRateAmount": 0.01047,
        "iyziCommissionFee": 0.075,
        "blockageRateAmountMerchant": "0E-8",
        "blockageRateAmountSubMerchant": "0E-8",
        "subMerchantPayoutAmount": "0E-8",
        "merchantPayoutAmount": 0.21453,
        "iyziConversionRate": 0,
        "iyziConversionRateAmount": 0,
        "currency": "TRY"
      }
    }
  ],
  "authCode": "579803",
  "phase": "AUTH",
  "hostReference": "mock00007iyzihostrfn",
  "signature": "5ab609ed2e0f4cae0035c8c136d29b00c2616cf8fb4856df65bb52b5a796369f"
}

Retrieve Payment Result

post

Ödeme sonucunu sorgular.

Header parameters

AuthorizationstringRequired

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

Example: IYZWSv2 aXBzaWduYXR1cmU...

Content-TypestringRequired

Content-Type değeri.

Example: application/json

Body

localestring · enumOptional

Dil kodu. Alabileceği değerler; tr, en. Default; tr

Example: trPossible values:

paymentIdstringRequired

Ödeme işlem ID’si.

Example: 25168803

paymentConversationIdstringOptional

Ödeme işlemine ait conversationId. paymentId gönderilmezse zorunludur.

Example: 123456789

Responses

200

Başarılı yanıt

application/json

statusstring · enumOptional

Yapılan isteğin sonucunu bildirir.

Example: successPossible values:

localestringOptional

Yanıt dili (tr/en).

Example: tr

systemTimeintegerOptional

İşlem zamanı (epoch ms).

Example: 1755198001941

conversationIdstringOptional

İstek ile eşleşen ID.

Example: conversationId

pricedecimalOptional

Sepet toplam tutarı.

Example: 1

paidPricedecimalOptional

Tahsil edilen toplam tutar.

Example: 1

installmentintegerOptional

Taksit sayısı.

Example: 1

paymentIdstringOptional

Ödeme ID’si.

Example: 25149157

fraudStatusinteger · enumOptional

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

Example: 1Possible values:

merchantCommissionRatedecimalOptional

Üye işyerinin uyguladığı vade/komisyon oranı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon oranı %10’dur. Bilgi amaçlıdır.

Example: 0

merchantCommissionRateAmountdecimalOptional

Üye işyerinin uyguladığı vade/komisyon tutarı. Örneğin price=100, paidPrice=110 ise üye işyeri vade/komisyon tutarı 10’dur. Bilgi amaçlıdır.

Example: 0

iyziCommissionRateAmountdecimalOptional

Ödemeye ait iyzico işlem komisyon tutarı.

Example: 0.2094

iyziCommissionFeedecimalOptional

Ödemeye ait iyzico işlem ücreti.

Example: 0.25

cardTypestring · enumOptional

Kart tipi.

Example: CREDIT_CARDPossible values:

cardAssociationstring · enumOptional

Kart kuruluşu.

Example: MASTER_CARDPossible values:

cardFamilystring · enumOptional

Kart ailesi.

Example: AxessPossible values:

binNumberstringOptional

BIN (ilk 8 hane).

Example: 552608

lastFourDigitsstringOptional

Kartın son 4 hanesi.

Example: 0006

basketIdstringOptional

Sepet ID.

Example: basketId

currencystring · enumOptional

Para birimi.

Example: TRYPossible values:

authCodestringOptional

Bankadan dönen authCode değeri.

Example: 214525

phasestringOptional

Ödeme Fazı.

Example: AUTH

hostReferencestringOptional

Ödemeye ilişkin banka tarafından verilen hostReference değeri.

Example: mock00001iyzihostrfn

signaturestringOptional

İmza doğrulaması için kullanılabilecek signature değeri.

Example: 5f510cd92b4b9c50a39b617cda228f4159f290860a4c20a965c55b119c9e9052

paymentStatusstring · enumOptional

Ödeme işleminin sonucunu gösterir.

Example: SUCCESSPossible values:

400

Hatalı istek / doğrulama hatası

application/json

post

/payment/detail

HTTP

POST https://api.iyzipay.com/payment/detail
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib....E0OGI1MTE=
Content-Type: application/json

{
  "paymentId":"25168803",
  "paymentConversationId":"123456789"
}

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1700000000000,
  "conversationId": "123456789",
  "paymentId": "1",
  "price": 1,
  "paidPrice": 1,
  "installment": 1,
  "fraudStatus": 1,
  "merchantCommissionRate": "0E-8",
  "merchantCommissionRateAmount": "0E-8",
  "iyziCommissionRateAmount": 0.0349,
  "iyziCommissionFee": 0.25,
  "cardType": "CREDIT_CARD",
  "cardAssociation": "MASTER_CARD",
  "cardFamily": "Axess",
  "binNumber": "552879",
  "lastFourDigits": "0008",
  "basketId": "B67832",
  "currency": "TRY",
  "itemTransactions": [
    {
      "itemId": "BI101",
      "paymentTransactionId": "27137212",
      "transactionStatus": 2,
      "price": 0.3,
      "paidPrice": 0.3,
      "merchantCommissionRate": "0E-8",
      "merchantCommissionRateAmount": "0E-8",
      "iyziCommissionRateAmount": 0.01047,
      "iyziCommissionFee": 0.075,
      "blockageRate": "0E-8",
      "blockageRateAmountMerchant": "0E-8",
      "blockageRateAmountSubMerchant": "0E-8",
      "blockageResolvedDate": "2025-08-22 00:00:00",
      "subMerchantPrice": 0,
      "subMerchantPayoutRate": "0E-8",
      "subMerchantPayoutAmount": 0,
      "merchantPayoutAmount": 0.21453,
      "convertedPayout": {
        "paidPrice": 0.3,
        "iyziCommissionRateAmount": 0.01047,
        "iyziCommissionFee": 0.075,
        "blockageRateAmountMerchant": "0E-8",
        "blockageRateAmountSubMerchant": "0E-8",
        "subMerchantPayoutAmount": "0E-8",
        "merchantPayoutAmount": 0.21453,
        "iyziConversionRate": 0,
        "iyziConversionRateAmount": 0,
        "currency": "TRY"
      }
    }
  ],
  "authCode": "579803",
  "phase": "AUTH",
  "hostReference": "mock00007iyzihostrfn",
  "signature": "5ab609ed2e0f4cae0035c8c136d29b00c2616cf8fb4856df65bb52b5a796369f",
  "paymentStatus": "SUCCESS"
}

Last updated 6 months ago

hashtagCreate Non3D Payment

hashtagRetrieve Payment Result

Create Non3D Payment

Retrieve Payment Result