Sorgulama

/payment/query endpoint'i, daha önce oluşturulmuş bir ödemenin güncel durumunu sorgulamanızı sağlar. Yanıtta ödeme durumu, tutar, sipariş numarası ve kullanıcı bilgisi yer alır. Bu endpoint özellikle callback alınamadığı durumlarda veya ödeme durumunu periyodik olarak doğrulamak istediğinizde kullanılır.

Ödeme Durumu Sorgulama

post

https://sandbox-api.iyzipay.com/v3/in-storehttps://api.iyzipay.com/v3/in-store

/payment/query

Belirtilen paymentId ile bir ödemenin güncel durumunu sorgular.

Query parameters

paymentIdLongRequired

Sorgulanacak ödemenin ID'si

Example: 1000001

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

Responses

200

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

application/json

statusstringOptional

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

Example: success

systemTimelongOptional

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

Example: 1750291200000

paymentIdintegerOptional

iyzico tarafından atanan benzersiz ödeme kimliği. İade ve sorgulama işlemlerinde referans olarak kullanılır.

Example: 1000001

orderIdstringOptional

Pos tarafındaki işlem numarası.

Example: 3270271271899321734IYZIOD

userIdstringOptional

Ödemeyi gerçekleştiren kullanıcının kimliği.

Example: user-1

AmountBigDecimalOptional

İşlem tutarı.

Example: 250.00

CurrencyCodestringOptional

İşlemin gerçekleştiği para birimi kodu.

Example: 1234

TransactionCodestringOptional

İşlem tipi kodu.

Example: Sale

RecordIdLongOptional

iyzico sistemindeki işlem kayıt numarası.

Example: 987654321

MaskedPanstringOptional

Maskelenmiş kart numarası.

Example: ******1234

AuthorizationCodestringOptional

Banka tarafından sağlanan yetkilendirme kodu.

Example: 123456

ResponseCodeValuestringOptional

Bankadan dönen ham yanıt kodu.

Example: 00

StatusCodestringOptional

İşlemin durum kodu.

Example: 00

HexColorstringOptional

İşlem durumuna karşılık gelen renk kodu.

Example: #4CAF50

ResultTextstringOptional

İşlem sonucunun kullanıcıya gösterilecek metni.

Example: ONAYLANDI

IsVoidablebooleanOptional

İşlemin iptal edilebilir olup olmadığını gösterir.

Example: true

IsRefundablebooleanOptional

İşlemin iade edilebilir olup olmadığını gösterir.

Example: false

BankResponseCodeValuestringOptional

Bankadan dönen yanıt kodu.

Example: 00

IssuerBinstringOptional

Kartı çıkaran bankanın BIN numarası.

Example: 450634

AcquirerIdstringOptional

İşlemi gerçekleştiren acquirer'ın kimliği.

Example: 1001

ClearingDatestring · nullableOptional

Takas tarihi. Henüz gerçekleşmemişse null döner.

HasDiscountbooleanOptional

İşlemde indirim uygulanıp uygulanmadığını gösterir.

Example: false

422

Validasyon hatası — eksik veya hatalı alan

application/json

500

Sunucu hatası

application/json

post/payment/query

HTTPcURLJavaScriptPython

POST /v3/in-store/payment/query?paymentId=1000001 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
Accept: */*

{
  "status": "success",
  "systemTime": 1750291200000,
  "paymentId": 1000001,
  "orderId": 123456789,
  "userId": "user-01",
  "transactionDetail": {
    "ScreenMessage": "00 Sale Approved",
    "Rrn": 123456789,
    "TransactionDate": "25 June 2026 17:43",
    "TransactionDateISO": 123456789,
    "Receipt": {
      "Detail": [
        {
          "Key": "Merchant ID",
          "Value": "XYZABC",
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "Terminal ID",
          "Value": "ABCXYZ",
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "Merchant Name",
          "Value": "kolaybutik",
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "Card Number",
          "Value": "******1234",
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "Authorization Code",
          "Value": "ABC123",
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "Operation Name",
          "Value": "Sale",
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "Status",
          "Value": "Approved",
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "Response",
          "Value": 0,
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "Message",
          "Value": "00 Sale Approved",
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "RRN",
          "Value": 123456,
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "Application Label",
          "Value": "Debit Mastercard",
          "ShowCheck": false,
          "ShowTimes": false
        },
        {
          "Key": "AID",
          "Value": "A000000",
          "ShowCheck": false,
          "ShowTimes": false
        }
      ],
      "PaymentBrandUrl": "https://propaytest.protel.com.tr/V2/mam/Content/images/nb_MASTERCARD.png",
      "SchemaName": "mastercard",
      "Approved": false
    },
    "Amount": "150.00",
    "CurrencyCode": "0949",
    "TransactionCode": "Sale",
    "RecordId": 987654321,
    "MaskedPan": "******1111",
    "AuthorizationCode": "AUTH01",
    "ResponseCodeValue": "00",
    "StatusCode": "Approved",
    "HexColor": "#F7C257",
    "ResultText": "Approved",
    "IsVoidable": true,
    "IsRefundable": true,
    "BankResponseCodeValue": "00",
    "IssuerBin": "411111",
    "AcquirerId": "0012",
    "ClearingDate": "2026-06-20T00:00:00.000+0300",
    "HasDiscount": false
  }
}