Skip to main content
Non-3D ödeme en basit ödeme akışıdır. Tek bir API isteğiyle ödeme tamamlanır — kart bilgileri Payven’e iletilir, akıllı yönlendirme motoru uygun bankayı seçer, banka onayı alınır ve sonuç dönülür.
Risk: Non-3D işlemlerde kart sahibi doğrulaması yapılmadığı için chargeback (ters ibraz) sorumluluğu sizdedir. Tüketici ödemelerinde 3D Secure önerilir. Non-3D, kapalı devre B2B akışları, abonelik yenilemeleri (CIT/MIT) veya düşük risk segmentleri için uygundur.

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 response 422 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 alanlar 422 Unprocessable Entity ile RFC 9457 problem+json döner:
Detay: Hata Yönetimi.

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?