Ödeme Akışı

Ödeme almanın iki yolu

Tahsilat için iki ürün var; hangisini seçtiğiniz entegrasyonunuzun biçimini değiştirir:

	Fatura	Ödeme kanalı
Nedir	Tek bir ödeme talebi	Tek bir müşterinin kalıcı yatırma kimliği
Tutar	Oluştururken sabitlenir	Yok — token'ın asgari tutarını karşılayan her yatırma hesaba geçer
Süre sonu	Var	Yok
Adres	Her fatura için ayrı bir adres	Ağ başına kalıcı tek adres; asla yeniden atanmaz
Nihai durum	paid, paid_over, underpaid, expired, cancelled	Yok — kanal, siz engelleyene kadar ödeme kabul eder
Ne için uygun	Ödeme sayfası, siparişler, tek seferlik ödemeler	Bakiye yükleme, düzenli gelen ödemeler, faturasını Paymos dışında kestiğiniz müşteriler

Sayfanın geri kalanı faturanın yaşam döngüsünü anlatır. Kanal tarafı için bkz. Ödeme Kanalı Oluştur: kanalın kendi yaşam döngüsü yoktur, gelen her yatırmanın vardır ve o çok daha kısadır — confirming → confirmed, zincir yeniden düzenlenirse aradan reorged geçer.

Yaşam döngüsü

Fatura tek bir nihai durumda biter: paid, paid_over, underpaid, expired veya cancelled. Çoğu geçiş bir webhook olayı tetikler — aşağıdaki durum tablosu hangilerini tetiklediğini listeler. confirming sonrasındaki her durum olay yayar. Ödeme öncesi iki durum yaymaz: awaiting_client sessiz açılır, ödeme sayfası token'ı onayladığında awaiting_payment durumuna geçiş de sessizdir. Tek istisna geriye doğru işler — derin bir reorg sayılan bütün transferleri düşürürse fatura awaiting_payment durumuna geri döner ve bu geri dönüş invoice.awaiting_payment olayını yayar.

İki oluşturma akışı

İki akış da aynı şekilde açılır. Fatura, arkasında henüz adres olmadan awaiting_client durumunda oluşturulur. Farklı olan; ne gönderdiğiniz ve müşteriye ne kadar karar bıraktığınızdır. Adres tahsisi — ve faturanın awaiting_payment durumuna geçişi — ödeme sayfasının token'ı onayladığı anda gerçekleşir.

Doğrudan kripto akışı — amount + currency + network gönderin. amount, ödenecek kripto tutarıdır ve hem token hem zincir oluşturma anında sabittir. Müşterinin karar verecek bir şeyi kalmaz; ödeme sayfası bu çifti onaylar ve adres hemen tahsis edilir.

Fiat akışı — amount + currency gönderin (network yok). amount bir fiat tutardır. Müşteri, barındırılan ödeme sayfasında token ve ağ seçer; Paymos o anda kur oranını kilitler, adres tahsis eder ve fatura awaiting_payment durumuna geçer. Kilitlenen kuru, tam payment.expected token tutarıyla birlikte faturadaki payment.exchange_rate alanından okuyun.

Tüm fiat kodları ve tokenlar için bkz. Desteklenen para birimleri; istek gövdesi için bkz. Fatura oluştur.

Durumlar

Durum	Açıklama	Webhook olayı
awaiting_client	Her faturanın açılış durumu — ödeme sayfası token'ı onaylayana kadar adres yok	—
awaiting_payment	Adres atandı, transfer bekleniyor	girişte — ; yalnızca reorg geri dönüşünde invoice.awaiting_payment
confirming	Ödeme algılandı, onaylar bekleniyor	invoice.confirming
underpaid_waiting	Kısmi ödeme alındı, kalan bekleniyor	invoice.underpaid_waiting
paid	Ödeme tam olarak onaylandı	invoice.paid
paid_over	Alınan tutar bekleneni aşıyor (tamamı hesaba geçer)	invoice.paid_over
underpaid	Yetersiz ödemeyle kapandı	invoice.underpaid
expired	Ödeme alınmadan süre doldu	invoice.expired
cancelled	Satıcı tarafından iptal edildi (yalnızca awaiting_client durumundan)	invoice.cancelled

İptal

Bir fatura yalnızca awaiting_client durumundayken iptal edilebilir — ödeme sayfası token'ı onaylamadan önce. Sonrasında adres yayında olur ve müşteriye belirli bir zincirde sabit bir tutar teklif edilmiş olur; iptal artık söz konusu değildir.

Zaman aşımları ve süre dolması

Ayar	Varsayılan
Token seçim penceresi (fiat akışı)	Yapılandırılabilir
Fatura süre sonu (adres atandıktan sonra)	Yapılandırılabilir
Eksik ödeme eşiği	Proje başına yapılandırılabilir
Fazla ödeme işlemi	Tamamı hesaba geçer

Müşteri, faturanın süresi dolmadan önce gerekli tutardan az gönderirse ortaya çıkan durum allow_multiple_payments ayarına bağlıdır:

• —allow_multiple_payments: true — durum underpaid_waiting olur; süre dolana kadar ek ödemeler kabul edilir
• —allow_multiple_payments: false — tek bir yetersiz ödeme faturayı anında underpaid ile kapatır

Süre underpaid_waiting durumundayken dolarsa, nihai durum toplam alınan tutar ve eksik ödeme politikasından çözülür. Müşteri beklenenden fazla gönderirse tutarın tamamı hesaba geçer ve durum paid_over olur.