Gate Pay Dokumentasi API Notifikasi Callback: https://docs.gate.com/api-reference/version/100/en/common/asyncNotification
Memahami Informasi Status Callback Pembayaran
Tipe Alamat Dinamis
1. Notifikasi Dana Masuk Pembayaran Alamat Dinamis (biztype = TRANSFER_ADDRESS)
TRANSFERRED_ADDRESS_IN_TERM: Dana dikreditkan secara instan selama periode validitas order.
TRANSFERRED_ADDRESS_DELAY: Jika pembayaran masuk setelah periode validitas, jumlah yang benar-benar dibayarkan akan dikreditkan ke akun saldo merchant (kredit instan setelah periode validitas).
2. Notifikasi Perubahan Status Order Pembayaran Alamat Dinamis (biztype = PAY_ADDRESS)
PAY_SUCCESS: Pembayaran berhasil.
PAY_CLOSE: Order kedaluwarsa.
PAY_EXPIRED_IN_PROCESS: Menunggu konfirmasi dana on-chain.
Tipe Alamat Statis
1. Pembayaran Alamat Statis Berhasil (biztype=PAY_FIXED_ADDRESS)
PAY_SUCCESS: Pembayaran berhasil dan dana telah dikreditkan.
2. Alamat Statis Ditandai sebagai Alamat Berisiko (biztype=FIXED_ADDRESS_RISK)
RISK_ADDRESS: Alamat statis telah ditandai sebagai alamat berisiko.
Tipe Pembayaran Alamat Abnormal
Untuk setiap transaksi pembayaran abnormal, Gate Pay akan mengirimkan notifikasi webhook ke merchant terkait.
bizType untuk tipe pembayaran ini selalu PAY_UNRESOLVED.
Merchant perlu menentukan permasalahan penagihan berdasarkan errorType pada data dan merujuk ke Panduan Penanganan Pembayaran Abnormal Gate Pay atau menghubungi account manager Gate Pay mereka.
- address_risk_address
— Alamat dinamis berisiko tinggi - address_error_currency
— Mata uang salah untuk alamat dinamis - address_error_chain
— Jaringan blockchain salah untuk alamat dinamis - fix_error_currency
— Mata uang salah untuk alamat statis - fix_error_chain
— Jaringan blockchain salah untuk alamat statis - fix_risk_address
— Alamat statis berisiko tinggi - fix_delete
— Alamat statis dihapus - fix_partial_delete
— Alamat statis dihapus sebagian
Tentang Informasi Callback untuk Pembayaran Alamat Dinamis
Mengapa Ada Dua Jenis Informasi Callback Pembayaran?
- Notifikasi Dana Masuk (TRANSFER_ADDRESS): Notifikasi jumlah dana yang benar-benar dikreditkan.
- Notifikasi Perubahan Status Order (PAY_ADDRESS): Notifikasi perubahan status order.
Merchant perlu menggunakan kedua jenis informasi ini untuk menentukan apakah sebuah order berhasil, sehingga dapat melanjutkan pengiriman atau menangani order yang gagal.
Kapan Notifikasi Callback Dikirimkan?
- Notifikasi Dana Masuk: Setelah konfirmasi pembayaran on-chain berhasil, dana akan langsung dikreditkan ke merchant dan callback dikirimkan ke merchant.
- Notifikasi Perubahan Status Order: Dipicu saat terjadi perubahan status order.
Skenario Pembayaran Alamat Dinamis dan Penentuan Status Order
1. Pembayaran Penuh Sekali atau Lebih dari Jumlah Order dalam Periode Validitas
Deskripsi: Selama pengguna membayar jumlah penuh atau melebihi jumlah order dalam periode validitas, callback akan dikirim secara real time setelah konfirmasi on-chain.
Status Order: Awalnya, sistem menunggu konfirmasi dana on-chain dan mengirim callback dengan status sementara: bizStatus adalah PAY_EXPIRED_IN_PROCESS. Setelah konfirmasi on-chain, order dinyatakan berhasil dan callback dikirim dengan bizStatus PAY_SUCCESS serta jumlah dana yang dikreditkan sebagai doneAmountOnChain.
Notifikasi Dana Masuk: bizStatus adalah TRANSFERRED_ADDRESS_IN_TERM, jumlah yang dikreditkan adalah transferAmount.
2. Pembayaran Kurang dalam Periode Validitas
Deskripsi: Jika pengguna membayar kurang dari jumlah order dalam periode validitas, setelah konfirmasi on-chain, jumlah yang benar-benar dibayarkan akan dikreditkan ke merchant dan callback dana masuk dikirim secara real time.
Status Order: Dalam periode validitas, status order tidak berubah dan tidak ada callback status order yang dikirimkan.
Notifikasi Dana Masuk: bizStatus adalah TRANSFERRED_ADDRESS_IN_TERM, jumlah yang dikreditkan adalah transferAmount.
3. Pembayaran Kurang dalam Periode Validitas, Tidak Dilunasi
Deskripsi: Jika pengguna membayar kurang dari jumlah order dalam periode validitas dan tidak melunasi kekurangannya selama periode tersebut.
Status Order: Ketika periode validitas order berakhir, callback status order dikirimkan. bizStatus adalah PAY_CLOSE, jumlah yang dikreditkan adalah doneAmountOnChain.
Notifikasi Dana Masuk: Callback dana masuk sudah dikirimkan setelah pembayaran dan tidak akan dikirim ulang.
4. Pembayaran Kurang dalam Periode Validitas, Kemudian Dilunasi
4.1 Pelunasan dalam Periode Validitas:
Setelah pengguna melunasi sisa pembayaran:
Status Order: Sistem menunggu konfirmasi dana on-chain dan mengirim callback dengan status sementara: bizStatus adalah PAY_EXPIRED_IN_PROCESS.
Notifikasi Dana Masuk: Tidak ada notifikasi dana masuk saat menunggu konfirmasi on-chain dari pelunasan.
Setelah Konfirmasi On-Chain:
Status Order: Setelah dana on-chain terkonfirmasi dan total jumlah mencukupi, order dianggap berhasil. bizStatus adalah PAY_SUCCESS, jumlah yang dikreditkan adalah doneAmountOnChain (total dari semua pembayaran).
Notifikasi Dana Masuk: bizStatus adalah TRANSFERRED_ADDRESS_IN_TERM, jumlah yang dikreditkan adalah transferAmount.
4.2 Pelunasan Setelah Periode Validitas:
Status Order: Karena jumlah penuh tidak dibayarkan dalam periode validitas, callback status order dikirim saat periode validitas berakhir. bizStatus adalah PAY_CLOSE, jumlah yang dikreditkan adalah doneAmountOnChain.
Notifikasi Dana Masuk: Callback dana masuk sudah dikirimkan setelah pembayaran dan tidak akan dikirim ulang.
Jika pengguna melunasi sisa pembayaran setelah periode validitas: callback dana masuk dikirim dengan bizStatus TRANSFERRED_ADDRESS_DELAY, jumlah yang dikreditkan adalah transferAmount. (Dalam kasus ini, tidak ada callback status order tambahan yang dikirim dan callback terakhir tidak menyertakan field doneAmountOnChain. Jika pengguna menyelesaikan pembayaran dengan beberapa transaksi, merchant harus menjumlahkan semua nilai transferAmount dari callback untuk mengonfirmasi total dana yang dikreditkan.)
5. Pembayaran Kedaluwarsa
Deskripsi: Jika pengguna membayar setelah periode validitas order, baik sebagian, penuh, maupun melebihi, dana akan dikreditkan secara real time setelah konfirmasi on-chain.
Perubahan Status Order: Karena tidak ada pembayaran yang dilakukan selama periode validitas, callback dikirim dengan bizStatus PAY_CLOSE saat periode validitas berakhir.
Dana Masuk: Tidak ada notifikasi dana masuk.
Pembayaran Setelah Kedaluwarsa: Setelah kedaluwarsa, untuk setiap pembayaran yang dilakukan, notifikasi dana masuk dikirim dengan bizStatus TRANSFERRED_ADDRESS_DELAY, jumlah yang dikreditkan adalah transferAmount. (Dalam kasus ini, tidak ada callback status order tambahan yang dikirim dan callback terakhir tidak menyertakan field doneAmountOnChain. Jika pengguna menyelesaikan pembayaran dengan beberapa transaksi, merchant harus menjumlahkan semua nilai transferAmount dari callback untuk mengonfirmasi total dana yang dikreditkan.)
Merchant perlu menggunakan kedua informasi callback status order dan dana masuk untuk menentukan apakah order berhasil.
6. Informasi Callback Order Abnormal untuk Pembayaran Alamat Dinamis
6.1 Pembayaran dengan Mata Uang atau Jaringan Blockchain yang Berbeda dari Order
Merchant akan menerima callback dengan Biztype=PAY_UNRESOLVED dan data.errorType=address_error_currency atau address_error_chain.
6.2 Dana Ditandai Berisiko dan Diblokir
Merchant akan menerima callback dengan biztype=PAY_UNRESOLVED dan data.errorType=address_risk_address.
Tentang Informasi Callback untuk Alamat Statis
1. Pembayaran Berhasil dan Dana Dikreditkan
Notifikasi PAY_SUCCESS akan diterima, menandakan pembayaran berhasil dan dana telah dikreditkan.
2. Callback Pembayaran Abnormal
2.1 Pembayaran dengan Mata Uang/Jaringan Berbeda dari Order
Merchant akan menerima callback dengan biztype=PAY_UNRESOLVED dan data.errorType=fix_error_currency atau fix_error_chain.
2.2 Dana Berisiko
Merchant akan menerima callback dengan biztype=PAY_UNRESOLVED dan data.errorType=fix_risk_address.
2.3 Pembayaran Dikirim ke Alamat Statis yang Telah Dihapus
Merchant akan menerima callback dengan biztype=PAY_UNRESOLVED dan data.errorType=fix_delete atau fix_partial_delete.
3. Notifikasi Risiko Alamat Statis
Notifikasi akan diterima dengan bizType=FIXED_ADDRESS_RISK dan bizStatus=RISK_ADDRESS, menandakan bahwa alamat penerima statis yang terhubung ke merchant telah diidentifikasi sebagai alamat berisiko. Merchant harus segera menghapus alamat statis terkait. Jika pengguna tetap melakukan pembayaran ke alamat ini, dana tidak akan dikreditkan.
Penafian
Konten yang disediakan di sini hanya untuk tujuan referensi dan edukasi, dan tidak dimaksudkan sebagai saran keuangan, investasi, perdagangan, atau hukum, maupun sebagai penawaran atau ajakan untuk membeli atau menjual aset digital apa pun. Gate tidak memberikan jaminan atau pernyataan, baik secara tersurat maupun tersirat, mengenai keakuratan, kelengkapan, atau ketepatan waktu informasi yang terkandung di sini. Fitur produk, antarmuka, aturan, dan struktur biaya dapat diperbarui atau disesuaikan kapan saja. Silakan merujuk pada pengumuman terbaru dan informasi aktual yang ditampilkan di platform Gate untuk detail yang paling akurat.
Investasi aset digital melibatkan risiko yang signifikan, dan harga dapat berfluktuasi secara substansial. Anda dapat kehilangan seluruh jumlah investasi Anda. Harap mengambil keputusan dengan hati-hati berdasarkan situasi keuangan dan toleransi risiko Anda sendiri setelah sepenuhnya memahami risiko yang terkait. Jika diperlukan, disarankan untuk berkonsultasi dengan penasihat keuangan atau hukum independen.
Untuk informasi lebih lanjut tentang risiko potensial, silakan merujuk pada Pengungkapan Risiko dan Perjanjian Pengguna Gate.
