Alamat khusus dan bersama untuk pembayaran USDT / USDC

2026-06-16 · Diperbarui 2026-10-01 · UUGate · 3 menit baca

Pembelian sekali dan saldo berulang memerlukan hubungan berbeda. Pilih berdasarkan objek bisnis, pencocokan jumlah, dan kewenangan tanda tangan, bukan hanya apakah alamat tetap.

Pilih jaringan dan model

Order bersama berjumlah tetap memetakan referensi merchant dan platform dengan kedaluwarsa dan aturan penggunaan jumlah. Order aktif berjumlah sama dapat menghasilkan 40105. Pengikatan khusus memetakan bindKey, jaringan, aset, dan alamat.

Parameter dan langkah integrasi

Gunakan POST /openapi/payin/orders untuk pembelian tetap dan POST /openapi/payin/exclusive-bindings untuk isi saldo. Kombinasi: TRC20-USDT, BEP20-USDT, BEP20-USDC, SPL-USDC. Mengubah model wallet tidak menambah jaringan.

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",
  "merchantOrderNo": "DEMO_PRODUCT_001",
  "amount": "10.00",
  "notifyUrl": "https://merchant.example.com/payments/notify"
}

Status, callback, dan pengecualian

Pengikatan bisnis bukan kewenangan tanda tangan. Wallet kustodian buatan platform dapat membayar sesuai izin. Alamat impor untuk pengamatan dapat dipantau, tetapi platform tidak dapat menandatangani pengiriman dari alamat itu.

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: pembelian 10.00 USDT menerima order dan checkout. MEMBER_DEMO_001 menyimpan pengikatan untuk deposit berikutnya. Kedua alur berakhir pada kredit terverifikasi sekali, tetapi pencarian pemilik dan hubungan order tetap berbeda.

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.