Provizyon Kapama

Provizyonun başarılı şekilde alınmasının ardından, işlemin nihai olarak tamamlanabilmesi için postAuth (provizyon kapama) işlemi gerçekleştirilmelidir. Bu aşamada, ön provizyonda alınan tutar ya tamamen veya kısmen onaylanarak müşterinin kartından çekilir. Eğer işlem belirtilen süre içinde kapatılmazsa, provizyon otomatik olarak iptal olabilir ve ödeme tamamlanmamış sayılır. Bu nedenle, satış sürecinin kesintisiz ilerleyebilmesi adına postAuth işleminin zamanında yapılması büyük önem taşır.

Önemli: BKM kurallarına göre 25 gün içerisinde provizyon kapama işlemlerinin gerçekleştirilmesi gerekmektedir. Bu süre zarfında finansallaştırılmayan işlemlerde, otomatik olarak bloke kaldırılmaktadır.

Ön provizyon süreleri, marjlı kapama limitleri ve işlem kuralları bankadan bankaya değişebilir.

Provizyon Kapama (PostAuth)

post

https://api.iyzipay.comhttps://sandbox-api.iyzipay.com

/payment/postauth

Başarılı şekilde ön provizyonu alınmış bir ödemeyi satışa çevirir.

Header parameters

AuthorizationstringRequired

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

Example: IYZWSv2 aXBzaWduYXR1cmU...

Content-TypestringRequired

İçerik tipi.

Example: application/json

Body

application/json

Daha önce ön provizyonu alınmış bir ödemenin kapama (tahsil) isteği.

localestring · enumOptional

Yanıt dili.

Example: trPossible values:

conversationIdstringOptional

İstek/yanıt eşleştirmesi için kullanılabilir.

Example: 123456789

paymentIdstringRequired

Gerçekleştirilen ön provizyon işlemine ait iyzico'dan dönen ödeme numarası bilgisi.

Example: 24534657

paidPricedecimalRequired

Karttan tahsil edilecek nihai tutar.

Example: 1

ipstringOptional

İsteği gönderen istemcinin IP adresi.

Example: 85.34.78.112

currencystringOptional

İşlem para birimi.

Example: TRY

Responses

200

Başarılı

application/json

Provizyon kapama (postAuth) yanıtı.

statusstring · enumOptional

İşlem sonucu.

Possible values:

localestring · enumOptional

Yanıt dili.

Example: trPossible values:

systemTimeintegerOptional

Sistem zamanı (epoch ms).

Example: 1752829032176

conversationIdstringOptional

Gönderildiyse, istekteki conversationId tekrarlanır.

Example: 123456789

pricedecimalOptional

Sepet toplam tutarı.

Example: 6

paidPricedecimalOptional

Tahsil edilen (kapama yapılan) tutar.

Example: 1

installmentintegerOptional

Taksit sayısı; 1 tek çekim anlamına gelir.

Example: 1

paymentIdstringOptional

Ödeme numarası.

Example: 24534657

fraudStatusinteger · enumOptional

Fraud tarama sonucu; 1=onay, 0=inceleme, -1=ret.

Example: 1Possible values:

merchantCommissionRatedecimalOptional

Üye işyeri uygulanan komisyon oranı.

Example: -83.33333333

merchantCommissionRateAmountdecimalOptional

Üye işyeri komisyon tutarı (bilgilendirme amaçlı).

Example: -5

iyziCommissionRateAmountdecimalOptional

iyzico komisyon tutarı.

Example: 0.0349

iyziCommissionFeedecimalOptional

iyzico işlem ücreti.

Example: 0.25

cardTypestring · enumOptional

Kart tipi.

Example: CREDIT_CARDPossible values:

cardAssociationstring · enumOptional

Kart ağı.

Example: MASTER_CARDPossible values:

cardFamilystringOptional

Kart ailesi (örn. Axess, World, Maximum vb.).

Example: Axess

binNumberstringOptional

Kartın ilk 8 hanesi.

Example: 55260800

lastFourDigitsstringOptional

Kartın son 4 hanesi.

Example: 0006

basketIdstringOptional

Üye işyeri tarafından gönderilen basketId bilgisi.

Example: 19323

currencystring · enumOptional

İşlemin gerçekleşmiş olduğu para birimi.

Example: TRYPossible values:

authCodestringOptional

Banka tarafından üretilen otorizasyon kodu.

Example: 699170

phasestringOptional

İşlem fazı.

Example: POST_AUTH

hostReferencestringOptional

Sistem içi referans alanı.

Example: mock00007iyzihostrfn

signaturestringOptional

Yanıt imza değeri (doğrulama için kullanılabilir).

Example: 92a1b7aeec0dff33df42f4d124b266638c22605b7acd74e10add24626a5c4871

post

/payment/postauth

HTTP

POST /payment/postauth HTTP/1.1
Host: api.iyzipay.com
Authorization: IYZWSv2 aXBzaWduYXR1cmU...
Content-Type: application/json

{
  "locale": "tr",
  "conversationId": "123456789",
  "paymentId": "24534657",
  "paidPrice": 1.0,
  "ip": "85.34.78.112",
  "currency": "TRY"
}

200

Başarılı

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1752829032176,
  "conversationId": "123456789",
  "price": 6,
  "paidPrice": 1,
  "installment": 1,
  "paymentId": "24534657",
  "fraudStatus": 1,
  "merchantCommissionRate": -83.33333333,
  "merchantCommissionRateAmount": -5,
  "iyziCommissionRateAmount": 0.0349,
  "iyziCommissionFee": 0.25,
  "cardType": "CREDIT_CARD",
  "cardAssociation": "MASTER_CARD",
  "cardFamily": "Axess",
  "binNumber": "552608",
  "lastFourDigits": "0006",
  "basketId": "basketId",
  "currency": "TRY",
  "itemTransactions": [
    {
      "itemId": "BI101",
      "paymentTransactionId": "26532053",
      "transactionStatus": 2,
      "price": 1,
      "paidPrice": 0.16666667,
      "merchantCommissionRate": -83.33333333,
      "merchantCommissionRateAmount": -0.83333333,
      "iyziCommissionRateAmount": 0.00581667,
      "iyziCommissionFee": 0.04166667,
      "blockageRate": 0,
      "blockageRateAmountMerchant": 0,
      "blockageRateAmountSubMerchant": 0,
      "blockageResolvedDate": "2025-07-26 00:00:00",
      "subMerchantPrice": 0,
      "subMerchantPayoutRate": 0,
      "subMerchantPayoutAmount": 0,
      "merchantPayoutAmount": 0.11918333,
      "convertedPayout": {
        "paidPrice": 0.16666667,
        "iyziCommissionRateAmount": 0.00581667,
        "iyziCommissionFee": 0.04166667,
        "blockageRateAmountMerchant": 0,
        "blockageRateAmountSubMerchant": 0,
        "subMerchantPayoutAmount": 0,
        "merchantPayoutAmount": 0.11918333,
        "iyziConversionRate": 0,
        "iyziConversionRateAmount": 0,
        "currency": "TRY"
      }
    },
    {
      "itemId": "BI102",
      "paymentTransactionId": "26532057",
      "transactionStatus": 2,
      "price": 2,
      "paidPrice": 0.33333333,
      "merchantCommissionRate": -83.33333333,
      "merchantCommissionRateAmount": -1.66666667,
      "iyziCommissionRateAmount": 0.01163333,
      "iyziCommissionFee": 0.08333333,
      "blockageRate": 0,
      "blockageRateAmountMerchant": 0,
      "blockageRateAmountSubMerchant": 0,
      "blockageResolvedDate": "2025-07-26 00:00:00",
      "subMerchantPrice": 0,
      "subMerchantPayoutRate": 0,
      "subMerchantPayoutAmount": 0,
      "merchantPayoutAmount": 0.23836667,
      "convertedPayout": {
        "paidPrice": 0.33333333,
        "iyziCommissionRateAmount": 0.01163333,
        "iyziCommissionFee": 0.08333333,
        "blockageRateAmountMerchant": 0,
        "blockageRateAmountSubMerchant": 0,
        "subMerchantPayoutAmount": 0,
        "merchantPayoutAmount": 0.23836667,
        "iyziConversionRate": 0,
        "iyziConversionRateAmount": 0,
        "currency": "TRY"
      }
    },
    {
      "itemId": "BI103",
      "paymentTransactionId": "26532058",
      "transactionStatus": 2,
      "price": 3,
      "paidPrice": 0.5,
      "merchantCommissionRate": -83.33333333,
      "merchantCommissionRateAmount": -2.5,
      "iyziCommissionRateAmount": 0.01745,
      "iyziCommissionFee": 0.125,
      "blockageRate": 0,
      "blockageRateAmountMerchant": 0,
      "blockageRateAmountSubMerchant": 0,
      "blockageResolvedDate": "2025-07-26 00:00:00",
      "subMerchantPrice": 0,
      "subMerchantPayoutRate": 0,
      "subMerchantPayoutAmount": 0,
      "merchantPayoutAmount": 0.35755,
      "convertedPayout": {
        "paidPrice": 0.5,
        "iyziCommissionRateAmount": 0.01745,
        "iyziCommissionFee": 0.125,
        "blockageRateAmountMerchant": 0,
        "blockageRateAmountSubMerchant": 0,
        "subMerchantPayoutAmount": 0,
        "merchantPayoutAmount": 0.35755,
        "iyziConversionRate": 0,
        "iyziConversionRateAmount": 0,
        "currency": "TRY"
      }
    }
  ],
  "authCode": "699170",
  "phase": "POST_AUTH",
  "hostReference": "mock00007iyzihostrfn",
  "signature": "92a1b7aeec0dff33df42f4d124b266638c22605b7acd74e10add24626a5c4871"
}

PHP

NodeJS

Python