Ödemeyi faturayla eşleştir

Genel bakış

Vakaların büyük çoğunluğunda alıcılar, kripto cüzdanınıza tam olarak faturada belirtilen tutarı öder. Ama bazen alıcı hata yapar ve ayrılan tutardan farklı bir tutar öder. Bu durumda hizmet, ödemeyi faturayla otomatik olarak eşleştiremez ve faturayı ödendi olarak işaretleyemez. Böyle olursa satıcı olarak siz, hangi ödemeyi beklediğinizden eminseniz ödemeyi faturayla manuel olarak eşleştirebilirsiniz. Bunu panelde veya API üzerinden yapabilirsiniz.

Eşleştirme koşulları

Eşleştirme, yalnızca tüm koşullar aynı anda sağlandığında gerçekleşir:

1. Fatura durumu — unpaid veya expired. İptal edilmiş ve zaten ödenmiş faturalar eşleştirilemez. İptal geri alınamaz.
2. Ödeme henüz başka bir faturayla eşleştirilmemiş. Bir ödeme yalnızca tek bir faturaya bağlanabilir.
3. Ödeme, bu faturada yer alan bir cüzdana gelmiş.
4. Ödeme, kullanılabilir ödeme penceresine sığıyor — fatura oluşturulmadan 24 saat öncesi ile 24 saat sonrası arasında. Fatura oluşturulmadan önce gelmiş bir ödeme eşleştirilebilir; pencerenin dışındaki eşleştirilemez.

Fatura başka bir projeye aitse ve anahtar bir projeyle sınırlanmışsa metot Restricted project yanıtı verir. Başka herhangi bir koşul sağlanmazsa, neden belirtilmeden genel bir hata döner — koşulları kendi tarafınızda kontrol edin.

Eşleştirmeden sonra ne olur

• Fatura Ödendi (Paid) durumuna geçer.
• Bildirimler e-postaya, Telegram botuna ve Webhook URL'ye gider — tıpkı otomatik eşleştirmedeki gibi.
• invoice.amountFiatUSD fatura tutarının üzerine fiilen alınan tutar yazılır, eşleştirme anındaki kurla USD'ye dönüştürülerek. invoice.amountFiat içindeki orijinal tutar değişmez.
• Hizmet ücreti, aldığınız tutar üzerinden projenin ücret oranıyla yeniden hesaplanır. Fazla ödemede fatura oluşturulurken hesaplanandan yüksek, eksik ödemede ise düşük olur.

İstek

curl -X POST https://api.bitsby.app/invoices/bindPayment \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay" \
	-F "invoiceId=ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c" \
	-F "paymentId=a4c9e2ee-9a03-43e5-a1a1-00caf679d16a"

İstek parametreleri

Parametre	Veri türü	Açıklama	Örnek	Zorunlu mu?
invoiceId	UUID	UUID biçiminde fatura ID'si	ade9550d-3dc7-4fd3-b94e-3b4c12aaaa0c	evet
paymentId	UUID	UUID biçiminde ödeme ID'si	a4c9e2ee-9a03-43e5-a1a1-00caf679d16a	evet

Yanıt örneği

{
   "result":"success",
   "data":"Invoice binded to payment"
}