Business Flow - Payments & Charges

Bu akış, canlı operasyonlarda tutarlılık ve izlenebilirlik sağlayacak şekilde tasarlanmıştır.

1) Payment oluşturma

Ödeme niyeti oluşturulur.

• amount, currency, customer_id, metadata gibi alanlar set edilir.
• Payment, confirm öncesi intent/prepare durumunda tutulur.

2) Payment confirm

Confirm adımında payment method ve payer identity verilerek ödeme başlatılır.

• payment_method zorunlu payload'dır.
• routing_strategy opsiyonel override olarak gönderilebilir.
• payer_identity (IP/user-agent vb.) fraud ve risk kararları için taşınır.

3) Charge üretimi

Confirm sonrası sağlayıcı denemesi charge kaydı ile izlenir:

• Hangi ödeme için deneme yapıldığı
• Tutarın ne kadar authorize/capture/refund olduğu
• Hangi rota ve hangi deneme sırasında sonucun üretildiği

4) Checkout Session akışı (alternatif giriş)

Checkout tabanlı akışta:

1. Checkout oturumu oluşturulur.
2. Token bazlı URL, ödeme yapacak kullanıcıya sunulur.
3. Confirm adımıyla ödeme tamamlanır.
4. Session gerektiğinde payment_id ile ödeme kaydına bağlanır.

• PENDING -> PROCESSING -> COMPLETED/FAILED
• Terminal durumlar: COMPLETED, FAILED, CANCELLED, EXPIRED
• final_amount ödeme başlamadan önce resolve edilmiş olmalıdır.

5) Refund akışı

• Refund, charges kaydı üzerinden ilerler.
• refunds tablosunda status, reason, amount, currency tutulur.
• Charge üzerinde refunded_amount alanı iade toplamını izler.

6) Operasyonel kapanış

• Merchant order state, sadece redirect sonucuna göre kapanmamalıdır.
• Sunucu tarafı payment/charge sorgusu veya webhook event'i ile final state doğrulanmalıdır.