Başarılı bir ödemenin tamamını veya bir kısmını iade edebilirsiniz. İade banka tarafında gerçekleşir; tutar müşterinin kartına geri yansır. Mutabakat öncesi yapılan iadeler “void/cancel” mantığıyla, mutabakat sonrası iadeler ise “refund” satırıyla işlenir — Payven bu kararı banka durumuna göre otomatik verir.
Endpoint
İstek
Idempotency-Key kullanın. Operatör arayüzünde butonun iki kez basılması veya client tarafı retry sırasında iki kez iade gerçekleşmesini engeller. Önerilen pattern: refund-{transaction_id}-{slot} (slot = 1, 2, 3 … her kısmi iade için artar).
Başarılı response
Wire seviyesinde partially_refunded adında bir status yoktur. Kısmi iade, ana Transaction’ın status’unu değiştirmez (completed kalır); her iade ayrı alt-Transaction kaydı olarak yazılır. Kalan iade edilebilir tutarı extra_properties.remaining_refundable veya GET /payments/{id} yanıtındaki refunded_amount alanından okuyun.
Çoklu kısmi iade
Bir işleme birden fazla kısmi iade yapabilirsiniz. Toplam iade tutarı orijinal işlem tutarını aşamaz.
İşlem detayını GET /api/v1/payments/{transaction_id} ile sorgulayarak kalan iade edilebilir tutarı extra_properties.remaining_refundable alanında görebilirsiniz.
Süre kısıtları
Mutabakat öncesi iadelerde banka komisyonu çoğu durumda yansımaz; mutabakat sonrası iadelerde komisyon iadesi banka anlaşmanıza tabidir. Anlaşma detayı için müşteri başarısı ekibine ulaşın.
Hata response’ları
Hata yanıtı RFC 9457 problem+json formatındadır. Detay: Hata Yönetimi.
Webhook olayları
Detay: Webhook Olayları.
Test
Sandbox’ta test kartlarıyla yapılan ödemeler iade edilebilir. Banka iade reddi senaryolarını tetiklemek için özel test kartlarını kullanın: Test Kartları. 
