Wallet eksklusif untuk deposit — disarankan

Panduan langkah demi langkah

Ikuti langkahnya di dasbor Anda. Klik gambar untuk memperbesar.

1. 1

   Untuk isi saldo anggota, kami menyarankan wallet eksklusif. Hubungkan satu alamat dengan setiap anggota agar bisa dipakai untuk deposit berulang. Nominal tidak perlu ditentukan sebelumnya dan tidak ada hitung mundur pembayaran. Ini menghindari masalah pencocokan akibat perbedaan nominal atau pesanan kedaluwarsa. Jaringan, aset, dan konfirmasi tetap harus diperiksa.

   

2. 2

   Buka daftar wallet, pilih Buat wallet, tentukan aset dan jaringan, lalu pilih Wallet eksklusif. Jika anggota mengirim USDT melalui TRON, pilih TRC20-USDT. Jaringan harus sesuai dengan jaringan pengiriman anggota. TRC20-USDT · BEP20-USDT · BEP20-USDC · SPL-USDC.

   

3. 3

   Isi informasi binding dengan ID anggota yang tetap dan unik. Nilai ini adalah bindKey pada API, bukan UID merchant. Untuk menambah saldo otomatis, masukkan URL callback server Anda. Jika kosong, pengaturan bawaan merchant akan digunakan. Periksa kuota sebelum membuat wallet. Contohnya, MEMBER_10001 adalah ID anggota. notifyUrl harus berupa URL HTTPS publik. Jangan memberikan alamat isi saldo biaya kepada anggota.

   

4. 4

   Filter daftar dengan mode Wallet eksklusif, lalu periksa aset dan alamat anggota. Wallet yang dibuat melalui API juga muncul di sini. Untuk anggota, jaringan, dan aset yang sama, gunakan kembali binding yang ada. Tidak perlu wallet baru untuk setiap deposit.

   

5. 5

   Buka checkout dari baris wallet. Tidak ada kolom nominal atau hitung mundur pembayaran. Berikan alamat lengkap atau tautan checkout kepada anggota yang sesuai. Anggota menentukan nominal deposit, dan sistem Anda menambah saldo sesuai dana yang benar-benar diterima. Biarkan wallet aktif untuk menerima deposit. Sebelum menonaktifkannya, beri tahu anggota agar berhenti mengirim dana ke alamat tersebut.

   

6. 6

   Untuk integrasi API, buka alat resmi dan pilih Buat wallet eksklusif. Isi aset, ID binding anggota, dan URL callback. Endpoint ini tidak memerlukan nominal, masa berlaku, atau nomor pesanan merchant. Pesanan penerimaan dibuat setelah deposit terdeteksi. POST /openapi/payin/exclusive-bindings · chainCode · tokenSymbol · bindKey · label? · notifyUrl?

   

7. 7

   Lakukan autentikasi dari server dengan Merchant UID + API Key serta header x-api-key, x-merchant-uid, x-timestamp, x-nonce, dan x-signature. Pesan HMAC-SHA256 terdiri dari tujuh baris: UID, timestamp milidetik, nonce, metode HTTP huruf besar, path tanpa query, query kanonis, dan body kanonis. Gunakan SDK resmi atau kode dari alat, dengan timestamp serta nonce baru untuk setiap permintaan. Periksa data sebelum membuat binding nyata.

   

8. 8

   Simpan bindingId, addressId, address, bindKey, chainCode, tokenSymbol, dan status; status seharusnya active. Kombinasi merchant + jaringan + aset + bindKey yang sama mengembalikan binding yang sudah ada. Pembuatan ulang tidak mengganti label atau notifyUrl. Respons tidak berisi cashierUrl: tampilkan address di halaman deposit Anda atau salin tautan checkout dari dasbor.

9. 9

   Gunakan GET /openapi/payin/exclusive-bindings/{bindKey}?chainCode=TRON&tokenSymbol=USDT&recentLimit=10. Encode bindKey untuk URL. GET tidak memiliki body, tetapi query ikut ditandatangani. Respons berisi stats, recentOrders, dan recentTransactions. recentLimit menerima 1 sampai 20 dan tidak menggantikan riwayat keuangan lengkap. Untuk satu pesanan, gunakan GET /openapi/payin/orders/{orderNo}.

10. 10

    Setelah deposit diproses, platform mengirim callback ke notifyUrl wallet, atau pengaturan bawaan jika kosong. Verifikasi rawBody dengan API Key yang terkait dengan pesanan, lalu periksa merchant, jaringan, aset, bindKey, dan status=completed. Tambahkan paidAmount, yaitu dana yang benar-benar diterima. Gunakan (merchantUid, orderNo) sebagai kunci unik dan simpan deduplikasi serta penambahan saldo dalam satu transaksi database. Kembalikan HTTP 2xx setelah berhasil. Akui notifikasi duplikat tanpa menambah saldo lagi. Jangan hanya memakai bindKey untuk deduplikasi karena deposit berikutnya akan terabaikan.

    

11. 11

    Pada pesanan penerimaan, filter berdasarkan alamat, label, atau ID binding. Periksa nominal, status, dan hash. API juga bisa mencari pesanan serta transaksi terbaru milik binding, lalu detail satu pesanan. Panduan tertulis menyediakan jalur endpoint dan contohnya. Cocokkan hasil dengan catatan wallet dan saldo anggota pada sistem Anda. Tombol Callback mengirim ulang notifikasi, bukan membuka riwayat. Pastikan deduplikasi bekerja sebelum memakainya.

    

12. 12

    Jika saldo anggota belum berubah, periksa jaringan, aset, dan konfirmasi. Setelah itu, periksa pesanan, URL callback, dan log server penerima. Jika tanda tangan gagal, periksa kanonisasi, waktu, dan nonce. Jika binding tidak ditemukan, periksa merchant, jaringan, aset, dan bindKey. Periksa juga status akun, kuota alamat, dan saldo biaya.