API isi saldo anggota USDT: pengikatan dan rekonsiliasi

2026-07-17 · Diperbarui 2026-10-01 · UUGate · 3 menit baca

Isi saldo harus mengenali pemilik deposit. Pembelian tetap memakai order; saldo berulang dapat memakai alamat khusus yang terikat ke identitas anggota stabil.

Pilih jaringan dan model

USDT didukung di TRON (TRC20) dan BSC (BEP20). Simpan bindKey, jaringan, aset, bindingId, dan alamat. Deposit anggota dan isi akun biaya merchant berbeda; jangan gunakan alamat biaya platform untuk anggota.

Parameter dan langkah integrasi

Buat atau gunakan kembali POST /openapi/payin/exclusive-bindings. bindKey adalah identitas anggota stabil dan notifyUrl callback HTTPS Anda. Query GET /openapi/payin/exclusive-bindings/{bindKey}?chainCode=TRON&tokenSymbol=USDT&recentLimit=10. bindKey bukan orderNo.

Body ini hanya ilustrasi: tidak ada request yang dikirim maupun data nyata. Panggilan lengkap membutuhkan UID, API Key, timestamp, nonce, dan tanda tangan di server. Kirim jumlah sebagai string dan gunakan perhitungan presisi untuk pembukuan.

{
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "bindKey": "MEMBER_DEMO_001",
  "label": "Demo member",
  "notifyUrl": "https://merchant.example.com/member-topups/notify"
}

Status, callback, dan pengecualian

Deposit menghasilkan catatan penerimaan. Periksa anggota, completed, paidAmount, dan jaringan sebelum kredit. stats kumulatif bukan jumlah deposit baru. Periksa recentOrders, query setiap order, dan gunakan deduplikasi yang sama untuk pemulihan.

Jika pembuatan penerimaan timeout tanpa orderNo, periksa transaksi bisnis asli di dasbor. Jangan menganggap merchantOrderNo menjamin retry pembuatan yang idempoten. Jika orderNo tersedia, periksa order platform itu. Deduplikasi callback berbeda dari retry pembuatan.

Gunakan API Key order asli dan rawBody tanpa perubahan. Verifikasi HMAC-SHA256(timestamp + "." + nonce + "." + rawBody) terhadap x-callback-signature. Lalu periksa identitas, order, aset, jaringan, dan jumlah. Transaksi database dan batasan unik mencegah kredit ganda. Balas HTTP 2xx setelah penyimpanan andal; pengalihan browser bukan konfirmasi pembayaran.

Contoh ilustratif integrasi

Contoh: MEMBER_DEMO_001 mengirim 10.00 dan 5.00 USDT pada TRON. Dua order terverifikasi memberi total 15.00. Pengiriman ulang callback kedua tidak menambah 5.00 lagi. Tidak ada anggota atau pembayaran nyata; validasi implementasi sebelum diluncurkan.

Pemeriksaan sebelum peluncuran

Tanda tangan sah lolos; perubahan body asli menggagalkan verifikasi.
Callback berulang dikreditkan sekali; proses terputus dapat dipulihkan.
Query, callback, pembukuan, dan transaksi jaringan dapat direkonsiliasi.
Salah jaringan, jumlah tidak cocok, kedaluwarsa, dan hasil tidak diketahui harus diperiksa.

Integrasi dan referensi teknis

Sumber ini menjelaskan standar dan metode teknis, bukan dukungan resmi untuk UUGate. Gunakan dokumentasi UUGate terkini untuk parameter integrasi.