API penerimaan USDC: integrasi BEP20 dan Solana

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

USDC cocok untuk produk digital, langganan, dan anggota yang memakai BSC atau Solana. Kenali jaringan yang tersedia terlebih dahulu. Nama aset sama tidak membuat pembayaran lintas jaringan setara.

Pilih jaringan dan model

BSC-USDC (BEP20) dan SOL-USDC (SPL) didukung dengan chainCode=BSC dan SOL. Siapkan wallet sesuai dan tampilkan jaringan, alamat, serta jumlah bersama. TRON-USDC dan jaringan rencana belum didukung.

Parameter dan langkah integrasi

Gunakan POST /openapi/payin/orders untuk pembelian berjumlah tetap. Simpan merchantOrderNo, orderNo, address, cashierUrl, dan expireAt sebelum membuka checkout yang dikembalikan. Pengikatan khusus dapat dipakai untuk pengisian saldo berulang.

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

Status, callback, dan pengecualian

Menunggu dan konfirmasi belum berarti pemenuhan berhasil. Keberhasilan penerimaan memakai completed. Gunakan GET /openapi/payin/orders/{orderNo} untuk callback yang tidak tersedia. Kekurangan pembayaran, salah aset atau jaringan, dan transfer terlambat perlu pemeriksaan tanpa janji pemulihan lintas jaringan.

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: produk seharga 10.00 USDC. Buat order BSC dan simpan referensi. Verifikasi callback completed lalu catat pembayaran dan satu izin unduh dalam transaksi yang sama. Callback berulang tidak memberikan izin tambahan; timeout memerlukan query order asli. Ini ilustrasi, bukan transaksi pelanggan.

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.