Sorgulama

Ödeme işlemi sonrası callback parametre değerindeki url'e yönlendiğinde url'de data ve paymentSessionToken değerleri dönecektir. Bu değerleri kullanarak ödemeyi sorgulayabilirsiniz.

Callback Yönlenme Örneği

https://siteadiniz.com/v2/callback?data=IqdsldBlBxKwe%2B8ap3GIk6iX4osaVV%2BUR%2F%2Bp2iB4QRtgV%2FAgnLOCu%2BJrgm43vBFYVUL6Iab0J%2F5EjuFdZhkN6GvPYb4gsmQQVMw1l4DJ0VYKsXLnb2Vnq%2BiF4GKN1Bv9JgFSslCV0b%2F0pz8Pjh8TRowLTPdx6RV%2FK%2FDjLgtnufRaGNzDIf6Sy8J1qc8h1z5djWFSJP6La1X8e4YZlS981QO8Zt1jHyAtvLmAZNY61swQS%2F4hdjBfu79Eo6qw6jF9b1XRaSpIW6UHvOf0hGBvFWQKvk7stga3iwZdsIblL9XMMhv3sLPgFqmuJS33Gm6zRYwHuMsW68SgCOw2%2BFrtDtzwRe0TyiyEwBuOfi92mpJX6%2FoJ8Sd4QX16KFQCmsa%2BoxFkIJbYSTlzVkmKu0bR1rEK3Xg%2Fo3awEKNvBiotD0voyubejTHPYeiJbEOnY8HCnaYWBjdnxnC92Sp0wk%2FN0Kss9WVZVV6ISRCxrbwXEVorjQRQzJ1OUYwoG3UA0RDV1%2FhJ1szySgwHUvnwCsk3GFsC%2FNV%2B3Y9GaRmFDj3NOrFb%2BomNmI5MtR38EQVruL5s8DsXViwryp2GWt03CH%2B3uXoX5CN1Yb3qIWyruSZD4KuE0VqqQoGmpzTSiC%2BDQtHwof2UIZSCKKS5jUP9AXyEcZoY2i1qj6NKlGaxCan2B%2Bvgjkd75wdYhWemb%2FJyF1in0oXZa7edFr0719yd8QoWLQ44abykYGZervwZKlWsqiks0J6VwYI4BfuzHc1dPgUE2oMPEKmBcjtLmLUhA0XGWXRiS7VO4F5kJMQkyIigFSSwUexQh6BBoQLl6ftbTv1wxq3fRVxvfIRRVHWam2rKpFzttV%2BaNSvkCH6WvsosbnOYlK%2FWmMDTXA1TfMxo8mBLd4yaqQUDvmAL86MNGs8eWnZE4UBPUT6NCaz0rUYlZvXTY4wo%2FYZS1AXO5YN4MF%2F57tpAJ4Z%2BXCOTwSGV3NgYjg0W%2FvgSFDGUwSveRWYW3Bao5IJ0HnQ1aESrwCxMXN89djgb76DVRBvf%2Fhn2ZE8e8jxsSNBgJT7%2BLX%2FXNzuqWG8ojyb2%2FcLtZy%2FJkkjYMHQLuiHAknF%2Fez5Jo2bORFZiHMb6wdIrJe1XUnuP9%2FP5DKsNGOIxsjHNGt1%2B3FL0lwNz6ccTB%2FzCKPeIrrowSckRheTvcxmMSokjSAmPSLWshFjt%2BOTO6IEB1HRzE7%2FSG7QIDw98gW%2FMiXpybC1cd6osWF5O22VUPAKCBsTOdjHzOyavNoSR2YHlF3oUa8Qvbdnt5HZnLnhRrFOa1pfgvOBuYxWdwW8eIoBcywCUVDZxgI%2Bn%2Bei2ASONMzc21%2B1O4dqJ1pT%2BW4QM0mFYtK8A9pMvBS1KyyVJYax%2FzYSzJHNXhlxRvF4KoEIVezBq%2Ffddh%2FgpOSMYLFA3j3HomCWUjq5d0WYIyDW0BohA6V0ZRS6Lmae5P3lI7rKzNtbO1hLC3bpmBxiVGAUTWayiihCK6nqHFl4ZjEgKs%2F9Rl5WrasMqAjbYktQj%2BVhdDqmlN8lC%2Bph%2F0QfwHAKacfZ27f7%2B7dCI2de4GCqopyMn4caolLaIrN2jg%2FAmTUehx4pkhP19WWS8VjI4VV1dBx192aSGGMPwabqXI6ADWZWm6vz9ybA3DMMUTLXF4Sqbb3C%2BlSzaffjggHoqO3A%2F54kYiZXNmLAHiFGpz5qdz5PpyAgw3dyQriJSMdhvqz84Ne%2FOmxz7lYdMsTk1S%2B7YgvvTcZu8C4b6FdqOf8YcNcZorA1dcrnqInDshlXGIu4bVIM7NEwzZpfOv9vnDGJJeSlYQGaiS5Ey2t2SLOBXQkrTEeWIURS0DOjzWXrPPmOP1mHCoFx5QEL6FKYfwTUxC%2B81kZtGOxTX7UcRcxhWB%2F5Ts08dS8tG%2Bi8PjZk6Xa1lMRKR6m5p3W90zblYxMviI9KX2zkI9hm4aom0AVTdbsEoSqkqEbE%2FU5SgGU2XSoewEL0lMd5bESOn%2FeVFj%2FHfRbQo6RhycfYPlScqDQfhYZ7%2BDLmd9ytj7pHtzVzdJCiPipb8aqpAig4JQSj5L69pApOurBQLI%2BtlZxJCfQBKVn%2BXGcA0HNHoNXk43%2F%2FCxLCunN3r9g0hqgE1iA2SEVBHC8ZX3WL6x42bYeKl1KvPJGahi6MBFlZT7xFU59SFZdzbH%2FKWLw7yA7YSXuU8HQlOQ%2BEo%2BfpJPKkpv8UeaQscZ8Xio6r8R3sFLSMA9gexQh6kIhoX%2B2kNPosfCihVr86ElLlHNZw7O2K1LJCAeGjcyR12WSkqZo4nEMRK39bz3VdnEBOFaXKN%2B3OJ%2FgVx%2FJu84NwZGBAxuDVTgQ%3D%3D&paymentSessionToken=EE99B54A87614135

POST https://api.iyzipay.com/v2/in-store/crypt/decrypt

Headers

Parametre
Zorunluluk
Veri Tipi
Açıklama

x-api-key

Zorunlu

String

CepPOS API Anahtarı

x-secret-key

Zorunlu

String

CepPOS Güvenlik Anahtarı

x-merchant-id

Zorunlu

Integer

Üye İşyeri Numarası

İstek Parametreleri

Parametre
Zorunluluk
Veri Tipi
Açıklama

data

Evet

String

Url'de dönen şifrelenmiş değer.

paymentSessionToken

Evet

String

Ödeme başlatılırken kullanılan benzersiz id'dir.

İstek Örneği

{
    "data": "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",
    "paymentSessionToken" : "EE99B54A87614135"
}

Url'de gelen data değerini url decode ederek kullanmanız gerekmektedir.

Yanıt Parametreleri

Kullanıcı listeleme servisinden dönen parametreler aşağıdaki gibidir.

Parametre
Veri Tipi
Açıklama

status

String

Yapılan isteğin sonucunu bildirir.

errorCode

String

İşlem hatalıysa, bu hataya dair belirtilen koddur.

errorMessage

String

İşlem hatalıysa, bu hataya dair belirtilen mesajdır.

errorGroup

String

İşlem hatalıysa, bu hataya dair belirtilen gruptur.

locale

String

İstekte belirtilen locale değeri geri dönülür, varsayılan değeri tr’dir.

systemTime

Integer

Dönen sonucun o anki unix timestamp değeridir.

conversationId

String

İstek esnasında gönderilmişse, sonuçta aynen geri iletilir.

inStoreCompleteOperation

String

Tamamlan ceppos işlemi değerleri

transaction

String

Tamamlan ceppos işlemi

transactionDate

String

Tamamlan ceppos işlemi tarihi

transactionDateISO

String

Tamamlan ceppos işlemi tarihinin ISO değeri

receipt

String

Tamamlan ceppos işleminin fiş bilgileri

detail

String

Tamamlan ceppos işleminin fiş bilgilerinin detayları

key

String

Tamamlan ceppos işleminin fiş bilgi başlığı

value

String

Tamamlan ceppos işleminin fiş bilgi değeri

paymentBrandUrl

String

Kart Kuruluşu Logosu

merchantLogoURL

String

Üye İşyeri Logo Linki

schemaName

String

Kart Kuruluşu

approved

String

Onay Durumu

refundApproved

String

İade Onay Durumu

voidApproved

String

İptal Onay Durumu

screenMessage

String

Ekran Mesajı

rrn

String

Yerleşik Kayıt Numarası

amount

String

Tahsil Edilen Tutar

currencyCode

String

Kur Kodu

transactionCode

String

İşlem Kodu

recordId

String

Kayıt No

maskedPan

String

Maskeli Kart No

authorizationCode

String

Otorizasyon Kodu

responseCodeValue

String

Yanıt Kodu Değeri

statusCode

String

Durum Kodu

resultText

String

Sonuç Metni

isVoidable

String

İptal Edilebilme

isRefundable

String

İade Edilebilme

bankResponseCodeValue

String

Banka Yanıt Kodu Değeri

issuerBin

String

Issuer Bin No

acquirerId

String

Acquirer No

clearingDate

String

Temizleme tarihi

hasDiscount

String

İndirim Durumu

hasInstallment

String

Taksit Durumu

paymentSession

String

Ödeme Oturumu

transactionType

String

İşlem Tipi

paymentFailedResult

String

Ödeme Başarısız Sonucu

Yanıt Örneği

{
    "status": "success",
    "errorCode": null,
    "errorMessage": null,
    "errorGroup": null,
    "locale": null,
    "systemTime": 1726788415127,
    "conversationId": null,
    "inStoreCompleteOperation": {
        "transaction": {
            "transactionDate": "20 Eylül 2024 02:25",
            "transactionDateISO": "2024-09-20T02:25:00.000+00:00",
            "receipt": {
                "detail": [
                    {
                        "key": "Merchant ID",
                        "value": "123456789"
                    },
                    {
                        "key": "Terminal ID",
                        "value": "012345"
                    },
                    {
                        "key": "Merchant Name",
                        "value": "iyzico"
                    },
                    {
                        "key": "Card Number",
                        "value": "************3276"
                    },
                    {
                        "key": "Authorization Code",
                        "value": "123456"
                    },
                    {
                        "key": "Operation Name",
                        "value": "Sale"
                    },
                    {
                        "key": "Status",
                        "value": "Approved"
                    },
                    {
                        "key": "Response",
                        "value": "00"
                    },
                    {
                        "key": "Message",
                        "value": "ISLEM ONAYLANDI ONAY KODU 123456"
                    },
                    {
                        "key": "RRN",
                        "value": "123456789"
                    },
                    {
                        "key": "Application Label",
                        "value": "MASTERCARD"
                    },
                    {
                        "key": "AID",
                        "value": "A123456798"
                    }
                ],
                "paymentBrandUrl": "https://propay.protel.com.tr/V2/mam/Content/images/nb_MASTERCARD.png",
                "merchantLogoURL": null,
                "schemaName": "mastercard",
                "approved": true,
                "refundApproved": false,
                "voidApproved": false
            },
            "screenMessage": "ISLEM ONAYLANDI ONAY KODU 123456",
            "rrn": "123456789",
            "amount": 26.0,
            "currencyCode": "0949",
            "transactionCode": "Sale",
            "recordId": 123456,
            "maskedPan": "************3276",
            "authorizationCode": "123456",
            "responseCodeValue": "00",
            "statusCode": "Approved",
            "resultText": "Approved",
            "isVoidable": true,
            "isRefundable": false,
            "bankResponseCodeValue": "00",
            "issuerBin": "526911",
            "acquirerId": "000000",
            "clearingDate": null,
            "hasDiscount": false,
            "hasInstallment": false
        },
        "paymentSession": null,
        "transactionType": null,
        "paymentFailedResult": null
    }
}

Last updated