Şifre Çözme

Callback URL'inize gelen şifreli data değeri, /crypt/decrypt endpoint'i aracılığıyla çözülür. İstek gövdesine şifreli veriyi ve ödeme başlatma adımından elde ettiğiniz paymentSessionToken'ı eklemeniz yeterlidir. Yanıt; ödeme durumu, tutar ve sipariş referansını açık metin olarak döner.

Ödeme Sonucu Şifre Çözme

post

/crypt/decrypt

Ödeme tamamlandıktan sonra callback ile gelen şifreli data değerini çözer ve ödeme sonucunu döner.

Header parameters

x-api-keystringRequired

iyzico panelinizdeki CepPOS API anahtarı

Example: YOUR_API_KEY

x-secret-keystringRequired

iyzico panelinizdeki CepPOS güvenlik anahtarı

Example: YOUR_SECRET_KEY

x-merchant-idstringRequired

iyzico hesabınızın üye işyeri numarası

Example: YOUR_MERCHANT_ID

Body

datastringRequired

Callback ile gelen şifreli ödeme verisi

Example: U2FsdGVkX1+ENCRYPTED_DATA_HERE==

paymentSessionTokenstringRequired

Ödeme başlatma adımında alınan token

Example: abc123xyz

Responses

200

Şifre başarıyla çözüldü

application/json

statusstringOptional

İşlemin sonucunu gösterir. Başarılı durumlarda "success" döner.

Example: success

systemTimeinteger · int64Optional

Sunucu tarafındaki işlem zamanı (Unix epoch, milisaniye).

Example: 1750291200000

400

Geçersiz parametre veya eksik alan

application/json

500

Sunucu hatası

application/json

post/crypt/decrypt

POST /v3/in-store/crypt/decrypt HTTP/1.1
Host: sandbox-api.iyzipay.com
x-api-key: YOUR_API_KEY
x-secret-key: YOUR_SECRET_KEY
x-merchant-id: YOUR_MERCHANT_ID
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "data": "U2FsdGVkX1+ENCRYPTED_DATA_HERE==",
  "paymentSessionToken": "abc123xyz"
}

{
  "status": "success",
  "systemTime": 1750291200000,
  "inStoreCompleteOperation": {
    "transaction": {
      "transactionDate": "19 Haziran 2026 10:30",
      "transactionDateISO": "2026-06-19T10:30:00.000+0300",
      "receipt": {
        "detail": [
          {
            "key": "Installment",
            "value": "3"
          }
        ],
        "paymentBrandUrl": "https://cdn.iyzipay.com/brands/visa.png",
        "schemaName": "VISA",
        "approved": true,
        "refundApproved": false,
        "voidApproved": false
      },
      "screenMessage": "İşleminiz başarıyla tamamlandı",
      "rrn": "623001234567",
      "amount": 150,
      "currencyCode": "text",
      "transactionCode": "Sale",
      "recordId": 987654321,
      "maskedPan": "******1111",
      "authorizationCode": "AUTH01",
      "responseCodeValue": "00",
      "statusCode": "Approved",
      "resultText": "Onaylandı",
      "isVoidable": true,
      "isRefundable": true,
      "bankResponseCodeValue": "00",
      "issuerBin": "411111",
      "acquirerId": "0012",
      "hasDiscount": false,
      "hasInstallment": true
    },
    "paymentFailedResult": {
      "transactionAmount": "33,33TRY",
      "paymentResultText": "Zaman Aşımı Gerçekleşti",
      "screenMessageText": "Zaman Aşımı Gerçekleşti",
      "date": "Jul 3, 2026 3:12:12 PM",
      "dateISO": 1783091532000
    }
  }
}