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

Metod	API URL	Parametreler
POST	https://posservice.esnekpos.com/api/services/OrderReturn	JSON File

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.

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.

Mağaza Alacak Azaltma

İşlem Listeleme Servisi

Last modified 3mo ago