TahsilatE Logo
Geliştirici Ortamı

İade

Başarılı bir ödemenin tamamını iade eder.

İade Servisi İstek Modeli

MethodEndpointBody
POST/external/vpos/v1/payments/{transactionId}/refund-
  • Yalnızca durumu SUCCESSFUL olan ödemeler iade edilebilir.
  • İade her zaman ödemenin tamamı içindir; kısmi iade desteklenmez.
  • Aynı ödeme için eşzamanlı gelen ikinci iade isteği reddedilir; ödeme iki kez iade edilmez.
  • Banka iadeyi reddederse HTTP 422 ve bankanın mesajı döner, ödeme SUCCESSFUL kalır ve tekrar denenebilir.
  • İade sonucu ayrıca webhook ile refund.completed olayı olarak bildirilir.

İstek Parametreleri

ParametreTipZorunluAçıklama
transactionId
string (yol)
Evet İade edilecek ödemenin işlem ID'si. Adreste yer alır; istek gövdesizdir.

Cevap Parametreleri

ParametreTipAçıklama
content.transactionId
string
İade edilen ödemenin işlem ID'si.
content.amount
number
İade edilen tutar (ödemenin tamamı).
content.status
string
SUCCESSFUL: iade tamamlandı. PENDING: banka iadeyi aldı, sonucu bekleniyor.
content.paymentStatus
string
Ödemenin yeni durumu: REFUNDED veya REFUND_PENDING.
content.message
string
Bankadan dönen mesaj.

Örnek Cevap JSON

12345678910

Hata Örneği

HTTP 409. Ödeme başarılı değilse, zaten iade edildiyse veya iade sürüyorsa döner.

1234