Ödeme İade (Refund)
Kimlik Doğrulama: Bearer token gereklidir.
Endpoint: POST /api/v1/payments/{id}/refund
Zincir üzerinde iade (payment facet üzerinde refund) kuyruğa alınır; custodial tarafında ödenen token tutarı ve varsa iade komisyonu için approve uygulanır. Integration'ın node'u ödemenin node'una erişebilmelidir.
Ön koşullar
- Ödeme
payment_methoddeğeriweb3olmalıdır. - Ödeme
statusdeğeriblockchain_distributedolmalıdır (zincirde yatırım + dağıtım / mutabakat tamamlandı). Aksi halde consumer işlemi atlar.
İstek gövdesi
Boş JSON {} kabul edilir (ödeme id path parametresi ile belirlenir).
Yanıt — 202 Accepted
{ "status": "accepted" }
| Kod | Açıklama |
|---|---|
| 403 | Ödemenin node'una erişim yetkisi yok |
| 404 | Ödeme bulunamadı |
İşlem asenkrondur; ödeme durumunu ve ödeme loglarını takip edin. Ödemenin cüzdanı ve ağı için webhook tanımlıysa, custody tamamlandığında veya hata verdiğinde platform success_path / error_path adreslerinize bildirim gönderebilir — bkz. Webhooks — işletmeye giden callback'ler.