Kırılım İade Etme

URL

Ödeme kırılım iade işlemi için kullanılan endpoint ve http metod bilgisi aşağıda verilmiştir.

HTTP Metod URL
POST /payment/v1/refund-transactions

İstek Parametreleri

İade işlemi gerçekleştirmek için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.

Parametre Adı Tipi Zorunlu Açıklama
paymentTransactionId number Evet İade yapılmak istenen ödeme kırılımının ID değeri
conversationId string Hayır İstekle beraber gönderilip, cevapla birlikte alınabilecek, "bumerang" değer. Farklı istekleri birbirleriyle ilişkilendirmek için kullanılabilir. Genellikle üye işyerinin ödemeye ilişkin sipariş numarası kullanılır
refundPrice number Hayır İade edilecek tutar
refundDestinationType RefundDestinationType Hayır İade karta ise CARD cüzdana ise WALLET girilecek olan alan. Default değer CARD bkz: İade Tipleri
chargeFromMe boolean Hayır İadeyi üye işyeri üstlensin mi? Pazaryeri ödemesinde satıcı bakiyesinin yetersiz olduğu durumda kullanılabilir

Dönüş Parametreleri

Parametre Adı Tipi Açıklama
id number İade işlemine dair üretilen iade ID değeri
conversationId string İstek ile beraber yollanan conversationId değeri
createdDate date İade yapılan tarih ve saat
status string Başarılı iade işlemleri için SUCCESS başarısız iade işlemleri için FAILURE döner
isAfterSettlement boolean İade edilen kırılım eğer para gönderimi sonrası iade işlemi gerçekleştiyse true para gönderimi öncesi gerçekleştiyse false değeri döner
refundPrice decimal Kırılıma ait iade edilen tutar
refundBankPrice decimal Kırılıma ait iade edilen banka tutarı
refundWalletPrice decimal Kırılıma ait iade edilen cüzdan tutarı
refundDestinationType RefundDestinationType İade karta ise CARD cüzdana ise WALLET girilecek olan alan. Default değer CARD bkz: İade Tipleri
authCode string İade edilen ödemeye ilişkin authCode değeri
hostReference string İade edilen ödemeye ilişkin hostReference değeri
transId string İade edilen ödemeye ilişkin transId değeri
currency Currency İade edilen tutarın para birimi. bkz: Para Birimleri
paymentTransactionId number İade edilen ödemenin kırılımına ait ID değeri
paymentId number İade edilen ödemeye ait ID değeri

Örnek Kodlar

Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.