İade/İptal Servisi

İade/İptal Servisi İstek Modeli;

MetodAPI URLParametreler

POST

https://base-url/api/services/OrderReturn

JSON File

Servise gönderilmesi gereken parametreler şu şekildedir;

ParametreTipZorunluAçıklama

MERCHANT

string

Evet

Üye iş yerine özel oluşturulan eşsiz kimlik bilgisidir.

MERCHANT_KEY

string

Evet

Üye iş yerine özel oluşturulan anahtar bilgisidir.

ORDER_REF_NUMBER

string

Evet

Üye iş yeri tarafından ödeme işlemi isteği gönderilirken verilmiş olan referans numarası bilgisidir. İptal edilecek ödeme işlemi ilgili üye iş yerine ait belirtilen referans numarası ile eşleştirilerek işlem gerçekleştirilir.

AMOUNT

int

Evet

İşlem yapılmak istenen referans numarasına ait İptal/İade tutar bilgisidir.

SYNC_WITH_POS

bool

Hayır

Ödemenin iade/iptal işlemini banka ile senkron bir şekilde gerçekleştirmenizi sağlayacak parametredir. False yollamanız durumunda anlık olarak banka tarafından onaylanmayan iade/iptal talebiniz sistemimize kaydedilir ve daha sonrasında operasyon birimimiz tarafından işleminiz tamamlanır.

Servise gönderilecek örnek bir JSON dosyası şu şekildedir;

                                            
{
      "MERCHANT": "TEST1234" , 
      "MERCHANT_KEY": "4oK26hK8MOXrIV1bzTRVPA==" ,
      "ORDER_REF_NUMBER" : "0.54251300 1595848596|93" ,
      "AMOUNT": 29.99,
      "SYNC_WITH_POS": false,
}
                                        

İade/İptal Servisi Cevap Mesajı;

Servisten işlem sonrasında gönderilen cevap mesajına ait parametreler şu şekildedir;

ParametreTipZorunluAçıklama

RETURN_CODE

string

Evet

İade işlemi sonucu durumu kod bilgisidir.

RETURN_MESSAGE

string

Evet

İade işlemi sonucu durum mesaj bilgisidir.

STATUS

string

Evet

İade işlemi sonucu durum bilgisidir.

ORDER_REF_NUMBER

string

Evet

Üye iş yeri tarafından ödeme isteğinde, isteğe ait verilen referans numarası bilgisidir.

REFNO

string

Evet

İade işlemine ait EsnekPos sistemi tarafından verilen referans numarası bilgisidir.

TRANSACTION_ID

int

Evet

İade işlemi kart bankası tarafından anlık olarak onaylanırsa EsnekPos sistemi tarafında ödemenin alt işlemlerine eklenen kaydın referans numarası bilgisidir.

                                            
{
    "RETURN_CODE": "0",
    "RETURN_MESSAGE": "29,99 ₺ iade talebiniz başarıyla kaydedilmiştir.",
    "STATUS": "SUCCESS",
    "ORDER_REF_NUMBER": null,
    "REFNO": null
}
                                        

İade/iptal işlem cevap mesajında STATUS parametresinin değeri SUCCESS ve RETURN_CODE parametresinin değeri 0 olarak dönmesi İade/iptal İşleminin başarılı olarak gerçekleştiğini ifade etmektedir.

Last updated