Checkout Session Rehberi

Checkout Session, ödeme deneyimini hızlı devreye almak isteyen ekipler için önerilen akıştır.

Akış özeti

1. Session oluşturulur.
2. Session URL/token kullanıcının önüne çıkarılır.
3. Kullanıcı ödeme bilgilerini girer.
4. Confirm adımıyla tahsilat başlatılır.
5. Session sonucu payment ile ilişkilendirilir.

Confirm anında toplanan kullanıcı alanları

Checkout confirm tarafında aşağıdaki alanlar toplanabilir:

• Payer: ad, e-posta, telefon
• Fatura adresi
• Teslimat adresi
• shipping_same_as_billing ile tek adres kullanım modeli
• Gerekiyorsa özel alanlar (custom fields)

Bu sayede hosted deneyimde gereken müşteri form verisi, ödeme tetiklenmeden önce tamamlanır.

Session durumları

• PENDING
• PROCESSING
• COMPLETED
• FAILED
• CANCELLED
• EXPIRED

Terminal durumlar (COMPLETED, FAILED, CANCELLED, EXPIRED) sonrası aynı session üzerinde yeni işlem başlatılmaz.

Neden session modeli kullanılır?

• Hosted deneyimle entegrasyon süresi kısalır.
• Token modeli ile kullanıcı akışı sadeleşir.
• Ödeme sırasında toplanan alanlar tek bir işlem bağlamında yönetilir.

En iyi pratikler

• Başarılı dönüş URL'sini tek başına ödeme kanıtı sayma.
• Session sonucu ile payment durumunu birlikte doğrula.
• Süresi dolan session'lar için kullanıcıya yeniden başlatma akışı sun.