Pusat Bantuan
Gate Pay
Panduan Integrasi Merchant

FAQ Gate Pay

2025-06-25 UTC
17879 Baca
3

Pertanyaan yang Sering Diajukan

Batas Jumlah Pesanan

1. Batas Jumlah Minimum: Pembayaran Gate: 0.0001 (semua unit mata uang)

Web3 Pembayaran On-Chain: 0,01 USDT (atau ekuivalen dalam mata uang lain)

Jumlah Minimum Pertukaran Flash: API kueri pasangan mata uang akan mengembalikan nilai maksimum dan minimum.

Jumlah pesanan tidak boleh lebih rendah dari jumlah minimum yang ditetapkan. Sebagai contoh, jika batas jumlah minimum adalah 0.0001, jumlah pesanan harus >= 0.0001, seperti 0.0001, 0.00011, dll.

2. Batas Presisi: Jumlah tempat desimal dalam jumlah pesanan tidak boleh melebihi presisi yang ditetapkan. Misalnya, jika presisi ditetapkan ke 0.0001 (yaitu, hingga 4 tempat desimal), 0.001 valid, tetapi 0.00011 akan menghasilkan kesalahan dan tidak akan dibulatkan.

Jumlah pesanan harus temui keduanya jumlah minimum dan persyaratan presisi, jika tidak, tidak dapat diserahkan. Misalnya, jika jumlah minimum adalah 0.0001 dan batas presisi adalah 0.1, 0.01 akan tetap tidak memenuhi persyaratan presisi dan akan mengakibatkan kesalahan.

Penjelasan Biaya Penarikan

API untuk Memeriksa Status Penarikan

https://www.gate.com/docs/developers/apiv4/id/#retrieve-withdrawal-status

Deskripsi

The "Periksa Status Penarikan" API memungkinkan pengguna untuk mengambil informasi biaya penarikan untuk berbagai token di berbagai rantai yang didukung. Pengguna dapat memilih rantai sesuai kebutuhan.

Parameter Biaya

withdraw_fix_on_chains: Biaya penarikan tetap

withdraw_percent_on_chains: Biaya penarikan berbasis persentase (berlaku untuk token khusus tertentu, dihitung sebagai Jumlah Penarikan × Tarif Persentase)

Rumus Perhitungan

Biaya Penarikan = Biaya Tetap + ( Persentase Tarif Biaya × Jumlah Penarikan)

Catatan Tambahan

Rantai yang paling umum digunakan hanya mengenakan biaya biaya penarikan tetap, yang pembaruan setiap jam.

Silakan Lakukan permintaan API sebelum setiap penarikan untuk memperoleh data biaya terbaru dan memastikan perhitungan yang akurat.

Mengapa pembayaran yang dilakukan dalam periode validitas ditandai sebagai pesanan yang kedaluwarsa?

Waktu pembayaran ditentukan berdasarkan kapan transaksi terdeteksi on-chain, bukan ketika pengguna memulai pembayaran. Penundaan dapat terjadi antara kedua waktu ini.

Mengapa tagihan yang ditampilkan di aplikasi atau web Gate berbeda dari pembayaran yang diterima?

Aplikasi atau web menampilkan jumlah pesanan, bukan jumlah yang sebenarnya dibayar oleh pengguna. Bahkan jika pembayaran pengguna berbeda dari jumlah pesanan, jumlah pesanan tetap akan ditampilkan. Untuk penagihan yang lebih rinci, selalu rujuk ke backend merch.

Arti dari merchantTradeNo dan merchantUserId dalam API Buat Pesanan

  1. merchantTradeNo: Nomor pesanan dalam sistem merch, dengan panjang maksimum 32 karakter.
  2. merchantUserId: ID akun pengguna dalam sistem merchant. Ini harus menjadi ID pengguna yang valid; jika tidak, pengembalian dana terkait pembayaran ke alamat akan gagal karena sistem tidak dapat mengidentifikasi pengguna.

Informasi Callback untuk Pembayaran Alamat On-chain

Mengapa Ada Dua Notifikasi Callback untuk Pembayaran?

  1. Notifikasi Kedatangan Dana (TRANSFER_ADDRESS): Pemberitahuan tentang dana yang diterima.
  2. Notifikasi Perubahan Status Pesanan (PAY_ADDRESS): Pemberitahuan tentang perubahan status pesanan.

Pedagang perlu mengandalkan dua jenis informasi ini untuk menentukan apakah pesanan berhasil untuk melanjutkan pengiriman atau menangani pesanan yang gagal.

Kapan Pemberitahuan Callback Dikirim?

  1. Notifikasi Kedatangan Dana Dikirim setelah pembayaran dikonfirmasi on-chain, memungkinkan dana untuk dikreditkan ke akun merchant secara real-time sambil memberi tahu merchant.
  2. Pemberitahuan Perubahan Status Pesanan Terpicu saat status pesanan berubah.

Memahami Status Callback

1. Notifikasi Kedatangan Dana (biztype = TRANSFER_ADDRESS)

  • TRANSFERRED_ADDRESS_IN_TERM: Dana dikreditkan secara real-time dalam periode validitas pesanan.
  • TRANSFERRED_ADDRESS_DELAY: Dana yang diterima setelah periode validitas akan dikreditkan ke akun pembayaran merchant (kredit real-time setelah periode validitas).
  • TRANSFERRED_ADDRESS_BLOCK: Transaksi memiliki risiko keamanan yang potensial dan ditolak. Silakan hubungi Gate Pay untuk bantuan dalam mengembalikan pembayaran.

2. Pemberitahuan Perubahan Status Pesanan (biztype = PAY_ADDRESS)

  • PAY_SUCCESS: Pembayaran berhasil.
  • PAY_CLOSE: Pesanan telah kadaluarsa.
  • PAY_EXPIRED_IN_PROCESS: Menunggu konfirmasi on-chain dari dana.

Skenario Pembayaran dan Penentuan Status Pesanan untuk Pembayaran Alamat On-chain

1. Pembayaran Penuh atau Kelebihan dalam Periode Validitas

Deskripsi : Jika seorang pengguna membayar jumlah penuh atau lebih dari jumlah yang diperlukan dalam periode validitas, setelah dikonfirmasi on-chain, kedua callback akan dipicu.

Notifikasi Status Pesanan :

  • Awalnya: bizStatus = PAY_EXPIRED_IN_PROCESS
  • Setelah konfirmasi: bizStatus = PAY_SUCCESS, doneAmountOnChain termasuk.

Notifikasi Kedatangan Dana : bizStatus = TRANSFERRED_ADDRESS_IN_TERM, jumlah yang dikreditkan = transferAmount.

2. Pembayaran Parsial dalam Periode Validitas

Deskripsi : Pengguna membayar kurang dari jumlah pesanan dalam periode validitas. Setelah dikonfirmasi on-chain, jumlah tersebut dikreditkan dan notifikasi kedatangan dana dikirim.

Notifikasi Status Pesanan : Tidak terpicu.

Notifikasi Kedatangan Dana : bizStatus = TRANSFERRED_ADDRESS_IN_TERM, amount = transferAmount.

3. Pembayaran Parsial tanpa Suplemen

Deskripsi : Pembayaran sebagian telah dilakukan, tetapi tidak ada jumlah lebih lanjut yang ditambahkan sebelum masa berlaku.

Pemberitahuan Status Pesanan : Dikirim setelah pesanan kedaluwarsa: bizStatus = PAY_CLOSE, amount = doneAmountOnChain.

Notifikasi Kedatangan Dana : Sudah dikirim sebelumnya ketika dana tiba. Tidak ada callback yang diulang.

4. Pembayaran Parsial dengan Suplemen

4.1 Ditambahkan Dalam Periode Validitas Notifikasi Status Pesanan :

  • Setelah tambahan: bizStatus = PAY_EXPIRED_IN_PROCESS
  • Setelah konfirmasi: bizStatus = PAY_SUCCESS, doneAmountOnChain mencerminkan total yang diterima.

Notifikasi Kedatangan Dana : Dikirim hanya setelah konfirmasi: bizStatus = TRANSFERRED_ADDRESS_IN_TERM, amount = transferAmount.

4.2 Ditambah Setelah Periode Validitas

Notifikasi Status Pesanan :

  • Pada masa kedaluwarsa: bizStatus = PAY_CLOSE, amount = doneAmountOnChain.
  • Tidak ada pemberitahuan status pesanan tambahan setelah suplemen terlambat.

Notifikasi Kedatangan Dana :

  • Setelah suplemen terlambat: bizStatus = TRANSFERRED_ADDRESS_DELAY, amount = transferAmount.
  • doneAmountOnChain tidak akan dimasukkan. Pedagang perlu mengagregasi beberapa nilai transferAmount secara manual.

5. Pembayaran Dilakukan Setelah Kadaluarsa

Deskripsi : Pengguna membayar setelah pesanan kedaluwarsa, terlepas dari jumlahnya.

Notifikasi Status Pesanan : Pada kedaluwarsa: bizStatus = PAY_CLOSE.

Pemberitahuan Kedatangan Dana :Setelah pembayaran terlambat: bizStatus = TRANSFERRED_ADDRESS_DELAY, amount = transferAmount. Tidak ada doneAmountOnChain dan tidak ada callback status pesanan untuk pembayaran setelah kadaluarsa. Merchant harus menjumlahkan semua nilai transferAmount yang diterima..

Pedagang harus menentukan keberhasilan pesanan berdasarkan status pesanan dan notifikasi panggilan balik kedatangan dana.

Daftar sekarang untuk mendapatkan kesempatan memenangkan hingga $10,000!
signup-tips