İade/İptal Servisi

İade/İptal Servisi İstek Modeli;
Metod
API URL
Parametreler
POST
https://posservice.esnekpos.com/api/services/OrderReturn
JSON File
Servise gönderilmesi gereken parametreler şu şekildedir;
Parametre
Tip
Zorunlu
Açı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.
Servise gönderilecek örnek bir JSON dosyası şu şekildedir;
{
"MERCHANT": "TEST1234" ,
"MERCHANT_KEY": "4oK26hK8MOXrIV1bzTRVPA==" ,
"ORDER_REF_NUMBER" : "0.54251300 1595848596|93" ,
"AMOUNT": 29.99
}
İade/İptal Servisi Cevap Mesajı;
Servisten işlem sonrasında gönderilen cevap mesajına ait parametreler şu şekildedir;
Parametre
Tip
Zorunlu
Açı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.