API pembayaran USDT / USDC: biaya dan hasil tidak diketahui

2026-06-27 · Diperbarui 2026-10-05 · UUGate · 4 menit baca

Pembayaran selesai ketika konfirmasi jaringan dan penyelesaian bisnis sesuai. Periksa dana, biaya, tujuan, dan referensi sebelum membuat order, lalu simpan status berikutnya.

Pilih jaringan dan model

API publik menyediakan pembayaran tunggal; pembayaran batch dilakukan di dasbor. Rute: TRON-USDT, BSC-USDT, BSC-USDC, SOL-USDC. Tujuan harus sesuai jaringan dan bukan wallet merchant sendiri. Wallet pengamatan tidak dapat menandatangani pembayaran.

Parameter dan langkah integrasi

POST /openapi/payout/orders menerima jaringan, aset, amount, toAddress, merchantOrderNo, dan notifyUrl. fromAddress opsional; platform dapat memilih sumber yang cukup. Ganti placeholder tujuan dengan alamat terverifikasi. Secara default jangan hapus alamat sumber setelah sukses.

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",
  "toAddress": "REPLACE_WITH_VERIFIED_TRON_ADDRESS",
  "amount": "35.50",
  "merchantOrderNo": "DEMO_PAYOUT_001",
  "notifyUrl": "https://merchant.example.com/payouts/notify"
}

Status, callback, dan pengecualian

Simpan orderNo PO dan query GET /openapi/payout/orders/{orderNo}. confirmed berarti berhasil; failed berarti gagal. submitted, broadcasted, atau tidak diketahui belum menyelesaikan pembayaran. Jangan mengganti referensi untuk membayar ulang; periksa transaksi bertanda tangan asli jika hasilnya tidak pasti.

Dana wallet dan akun biaya terpisah. Sebelum pembayaran, periksa saldo sumber nyata dan saldo biaya jaringan yang cukup. Saldo biaya negatif memblokir operasi penting. Lihat harga, kuota, dan biaya saat ini; perkiraan gas bukan biaya UUGate.

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: bayar 35.50 USDT kepada mitra dan simpan orderNo. Setelah jaringan terputus, query order asli lalu catat penyelesaian sekali setelah confirmed. Hasil tidak diketahui tetap diproses sambil memeriksa txHash. Selidiki kegagalan sebelum pemulihan sesuai dokumentasi. Tidak ada dana dikirim.

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.

Pembayaran USDT massal: konsol, biaya dan hasil tiap pembayaran

API publik hanya menyediakan pembayaran satuan. Pembayaran USDT massal dilakukan di konsol merchant. Mengulang permintaan satuan bukan API batch atomik dan tidak menjamin seluruh pembayaran berhasil atau dibatalkan bersama.

Ikuti tutorial, periksa tujuan dan jaringan tiap baris, dana sumber serta saldo biaya yang cukup untuk seluruh batch. Selesaikan 2FA yang diwajibkan. Dana dompet dan akun biaya diperiksa terpisah.

Rekonsiliasi tiap catatan, status dan hash. Untuk kegagalan sebagian atau hasil belum diketahui, simpan serta kueri catatan asli. Jika sudah ditandatangani, verifikasi atau siarkan ulang tanda tangan asli; jangan menandatangani pembayaran baru yang bisa menggandakan kiriman.