İade
Başarılı bir ödemenin tamamını iade eder.
İade Servisi İstek Modeli
| Method | Endpoint | Body |
|---|---|---|
| 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
| Parametre | Tip | Zorunlu | Açıklama |
|---|---|---|---|
| transactionId | string (yol) | Evet | İade edilecek ödemenin işlem ID'si. Adreste yer alır; istek gövdesizdir. |
Cevap Parametreleri
| Parametre | Tip | Açı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
