İade/İptal Servisi

İade/İptal Servisi İstek Modeli;

Metod	API URL	Parametreler
POST	https://base-url/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.
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;

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,
    "TRANSACTION_ID": 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.