Pencocokan pembayaran dan selisih jumlah

Bagian ini menjelaskan aturan yang dipakai layanan untuk mencocokkan transaksi on-chain masuk dengan tagihan yang diterbitkan, apa yang terjadi saat jumlahnya berbeda, dan apa yang dapat dilakukan merchant dalam kasus itu.

Status tagihan, batas waktu, dan transisi status dijelaskan di Siklus hidup tagihan.

Aturan kecocokan jumlah

Saat pembuatan tagihan, layanan mengonversi jumlah fiat menjadi kripto dan mengunci jumlah hasilnya untuk tagihan itu. Jumlah tersebut menjadi identifikasi pembayaran: pembeli melihatnya di formulir pembayaran, dan layanan mencari transaksi dengan jumlah persis itu di on-chain.

Jumlah pembayaran harus persis sama dengan jumlah tagihan. Tidak ada toleransi. Jumlah yang harus dibayar dibentuk dengan 2 angka desimal untuk stablecoin USDT dan USDC dan 8 angka desimal untuk mata uang kripto lain, dan pembayaran masuk dibandingkan dengannya secara presisi. Penyimpangan apa pun—kurang bayar atau lebih bayar, sekecil apa pun—berarti pencocokan otomatis tidak akan terjadi.

Contoh. Tagihan sebesar 100.00 USD diterbitkan dengan jumlah terkunci 100.12 USDT.

Jumlah pembayaran masuk	Hasil
100.12 USDT	Tagihan otomatis berpindah ke Dibayar (Paid)
100.11 USDT	Tidak ada pencocokan otomatis
100.50 USDT	Tidak ada pencocokan otomatis

Jika beberapa tagihan dengan jumlah fiat yang sama diterbitkan ke satu alamat pada waktu bersamaan, layanan memberi masing-masing jumlah kripto yang sedikit berbeda. Keunikannya diperiksa di seluruh tagihan belum dibayar Anda pada dompet itu, sehingga satu alamat aman dipakai di beberapa proyek Anda—jumlahnya tidak akan bertabrakan.

Penyebab ketidakcocokan yang paling umum adalah pembeli membulatkan jumlah secara manual atau biaya jaringan terpotong saat penarikan dari exchange. Ingatkan pembeli untuk mentransfer persis jumlah yang tertera di formulir pembayaran.

Apa yang terjadi saat selisih jumlah

Layanan mencatat bahwa dananya masuk tetapi tidak mengambil tindakan apa pun atas tagihan:

• Tagihan tidak berubah status. Tagihan tetap belum dibayar sampai batas waktu pembayaran. Pembeli masih bisa menutupnya dengan jumlah yang benar selama jendela pencarian terbuka.
• Webhook tidak dikirim. Notifikasi ke Webhook URL keluar hanya pada saat tagihan berpindah ke Dibayar.
• Pembayaran parsial tidak dilacak. Layanan tidak mengenali kurang bayar dan tidak menyimpan sisa tagihan yang harus dibayar.
• Pembayaran tidak dijumlahkan. Jika setelah kurang bayar pembeli mengirim transaksi kedua sebesar kekurangannya, kedua pembayaran itu tidak dijumlahkan. Keduanya tetap menjadi pembayaran terpisah yang tak tercocokkan.
• Lebih bayar tidak dikembalikan otomatis. Dana masuk langsung ke dompet Anda; pengembalian selisihnya kepada pembeli ditangani di luar layanan.

Tidak ada status antara seperti Dibayar sebagian atau Lebih bayar di layanan ini.

Cara merchant mengetahui masalahnya

Jika notifikasi diaktifkan di pengaturan proyek, merchant menerima email dan pesan bot Telegram tentang setiap pembayaran masuk—terlepas dari cocok atau tidaknya dengan tagihan.

Ini memberi aturan diagnostik sederhana: jika notifikasi pembayaran masuk tiba tetapi notifikasi tagihan dibayar tidak menyusul, pembayaran tidak cocok karena selisih jumlah dan memerlukan penanganan manual.

Aturan ini bekerja hanya dalam jendela pencarian. Layanan memantau dompet hanya selama setidaknya satu tagihan masih memiliki pencarian aktif. Jika pembeli membayar saat tagihan seperti itu tidak ada, pembayaran sama sekali tidak masuk ke sistem—tanpa notifikasi, dan tanpa cara mencocokkannya secara manual.

Anda juga dapat menemukan pembayaran tak tercocokkan secara terprogram. Metode payments/list mengembalikan pembayaran di seluruh dompet Anda, dan pembayaran yang tidak tercocokkan dengan tagihan tidak memiliki blok invoice dalam respons. Itulah kandidat pencocokan manual: bandingkan jumlah dan waktunya dengan tagihan yang diharapkan dan panggil invoices/bindPayment.

Pencocokan pembayaran manual

Jika Anda yakin pembayaran mana yang sesuai dengan tagihan mana, cocokkan secara manual—di dasbor pada halaman tagihan atau di daftar pembayaran, atau lewat API dengan metode invoices/bindPayment.

Syarat pencocokan

Pencocokan hanya mungkin saat semua syarat terpenuhi sekaligus:

1. Tagihan berstatus Belum dibayar atau Kedaluwarsa. Tagihan yang dibatalkan dan yang sudah dibayar tidak dapat dicocokkan.
2. Pembayaran belum tercocokkan dengan tagihan lain. Satu pembayaran hanya dapat terikat pada satu tagihan.
3. Pembayaran masuk ke dompet yang terlibat dalam tagihan ini.
4. Pembayaran berada dalam jendela pembayaran yang tersedia—24 jam sebelum dan 24 jam sesudah pembuatan tagihan.

Jendela ini lebih lebar daripada masa berlaku tagihan, dan itu membuka dua kemungkinan: Anda dapat mencocokkan pembayaran dengan tagihan yang sudah kedaluwarsa, dan Anda dapat mencocokkan tagihan dengan pembayaran yang masuk sebelum tagihan dibuat. Yang kedua berguna saat pembeli mengirim uang atas inisiatif sendiri dan tagihan diterbitkan setelah dananya masuk.

Apa yang terjadi setelah pencocokan

• Tagihan berpindah ke Dibayar—sama seperti pada pencocokan otomatis.
• Webhook selalu dikirim. Notifikasi keluar pada setiap transisi ke Dibayar, bagaimanapun pencocokannya dilakukan.
• Jumlah tagihan dalam USD dihitung ulang dari pembayaran nyata. Field amountFiatUSD ditimpa dengan jumlah yang benar-benar diterima, dengan kurs pada saat pencocokan. Jumlah asli di amountFiat tidak berubah.
• Biaya dihitung ulang dari jumlah nyata. Biaya dikenakan menurut tarif proyek atas jumlah yang Anda terima.