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
    }
}