Status transaksi
Setiap baris transaksi di dasbor punya salah satu status ini. Statusnya mencerminkan event terbaru untuk transaksi itu; pengembalian dana dan sengketa memperbarui baris yang ada alih-alih menyisipkan baris saudara.
| Status | Makna |
|---|---|
succeeded | Pembayaran selesai. Uangnya ada di akun Anda (setelah biaya penyedia). |
pending | Pembayaran dalam perjalanan. Umum dengan metode pembayaran asinkron (ACH, sebagian metode kripto) di mana konfirmasi butuh menit hingga jam. |
failed | Pembayaran tidak selesai: kartu ditolak, otorisasi kedaluwarsa, penolakan keras. Tidak ada uang yang berpindah. |
partial | Pembeli membayar kurang dari yang ditagihkan (umum saat pembeli kripto mengirim jumlah yang berkurang oleh biaya jaringan). amount barisnya mencerminkan yang benar-benar diterima; periksa metadata.invoicedAmount untuk yang diminta. |
refunded | Uang telah dikembalikan ke pembeli, penuh atau sebagian. amount barisnya adalah jumlah yang dikembalikan; pengembalian dana bisa terjadi berhari-hari atau berminggu-minggu setelah pembayaran awal. |
disputed | Pembeli (atau bank mereka) membuka sengketa atau chargeback. Periksa antarmuka penyedia untuk jendela tanggapan. metadata.reason barisnya membawa klasifikasi penyedia apa adanya. |
pending_manual | Transaksi bayar-lewat-pos menunggu konfirmasi fisik Anda. Lihat bagian berikutnya. |
manual_canceled | Anda mengklik Batalkan pada baris bayar-lewat-pos yang tertunda sebelum pembayaran pembeli tiba. |
manual_expired | Sebuah baris bayar-lewat-pos yang tertunda dibiarkan 30 hari tanpa konfirmasi dan kedaluwarsa otomatis. |
manual_revoked | Anda mengonfirmasi penerimaan pembayaran bayar-lewat-pos tapi kemudian membatalkan konfirmasinya (mis. pembayarannya ternyata tidak valid). Barisnya berpindah dari succeeded kembali ke status terminal ini. |
Pengembalian dana, sengketa, pembayaran parsial
Coin Moebius mendengarkan event penyedia ini dan memperbarui baris transaksi awal di dasbor. Khususnya:
- Pengembalian dana: event
charge.refundeddari Stripe (pengembalian penuh atau parsial, termasukamount_refundedagar pengembalian parsial menampilkan bagian yang dikembalikan). IPNrefundeddari NOWPayments. Status barisnya berubah menjadirefunded,amountmencerminkan jumlah yang dikembalikan, danmetadata.originalChargeId/metadata.originalAmountmembawa konteks pembayaran awal. - Sengketa (chargeback): event
charge.dispute.createddari Stripe. Status barisnya berubah menjadidisputed. Alasan yang dinyatakan penyedia diteruskan kemetadata.reasonapa adanya, Anda bisa merendernya di antarmuka Anda sendiri sesuka Anda. - Pembayaran parsial: IPN
partially_paiddari NOWPayments. Status barisnya berubah menjadipartial.amountmencerminkan yang benar-benar diterima (actually_paid);metadata.invoicedAmountadalah yang diminta.
Di v1, event ini dimunculkan di dasbor dan lewat endpoint /status. Rilis mendatang akan menambahkan notifikasi email dan penerus webhook keluar agar backend Anda sendiri bisa bereaksi otomatis. Untuk sekarang, siapkan pekerjaan polling kecil (lihat bagian berikutnya) atau periksa dasbor.