Endpoint
Akış
İstek
İstek alanları
İlgili headers — bu istek için zorunlu olanlar:
Authorization: Bearer <token>(Identity’den alınan access token)Idempotency-Key(önerilir — yeniden gönderim koruması için bkz. Idempotency)Content-Type: application/json
Başarılı response
HTTP 200 + status: "completed" → ödeme başarıyla tamamlandı. Detaylı alan referansı: Payment Objesi.
Banka tarafından red
Banka reddinde response422 Unprocessable Entity + application/problem+json döner; code: "bank_declined" ile birlikte bankanın orijinal kodu provider_error_code alanında taşınır. Tam payload yapısı: Hata Yönetimi. Banka kodları: Banka Yanıt Kodları.
Sonradan GET /api/v1/payments/{id} ile sorgulandığında failed ödeme 200 OK döner; error_code ve provider_error_code response body’sinde yer alır.
Validasyon hatası
Eksik veya geçersiz alanlar422 Unprocessable Entity ile RFC 9457 problem+json döner:
Sonraki adımlar
3D Secure'a geçin
Tüketici işlemlerinde chargeback riskini azaltın.
İade işlemi
Tam veya kısmi iade nasıl yapılır?
Webhook entegre edin
Asenkron sonuçları gerçek zamanlı alın.
Akıllı yönlendirme
Birden fazla bankaya nasıl yönlendirilir?