Buat Dompet Eksklusif

Membuat alamat penerima eksklusif untuk bindKey. Setoran mendatang ke alamat ini secara permanen menjadi milik bindKey tersebut.

Jika notifyUrl disediakan, pesanan isi ulang yang dibuat secara otomatis di masa mendatang untuk alamat eksklusif ini akan melakukan panggilan balik ke URL tersebut terlebih dahulu. Ini berguna ketika setiap situs atau aplikasi menerima notifikasi isi ulang anggotanya sendiri.

POST/openapi/payin/exclusive-bindings

Header

Kolom	Tipe	Wajib	Deskripsi
x-api-key	string	Ya	Pedagang API Key. Gunakan nilai yang diawali dengan mch_ dari halaman pengaturan API pedagang.
x-merchant-uid	string	Ya	Merchant UID.
x-timestamp	string	Ya	13 digit milidetik timestamp. Penyimpangan jam yang diperbolehkan secara default adalah 5 menit.
x-nonce	string	Ya	String acak unik untuk setiap permintaan, hingga 128 karakter. Penggunaan kembali ditolak.
x-signature	string	Ya	Tanda tangan hex dihasilkan dengan HMAC-SHA256. Payload berisi Merchant UID, timestamp, nonce, metode, jalur, query kanonik, dan body kanonik.

Parameter

Kolom	Tipe	Wajib	Deskripsi
chainCode	string	Ya	Kode rantai. Nilai yang didukung: TRON / BSC / SOL.
tokenSymbol	string	Ya	Simbol token.
bindKey	string	Ya	Kunci pengikatan unik di sisi pedagang.
label	string	TIDAK	Komentar yang mengikat.
notifyUrl	string	TIDAK	Panggilan balik independen URL untuk alamat eksklusif ini. Pesanan yang dibuat secara otomatis dari setoran masa depan akan dipanggil kembali ke sini terlebih dahulu.

Contoh permintaan

{
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "bindKey": "USER_90001",
  "label": "VIP User 90001",
  "notifyUrl": "https://merchant.example.com/api/uugate/member-topup-notify"
}

Kolom respons

Kolom	Tipe	Wajib	Deskripsi
bindingId	number	Ya	Mengikat ID rekaman.
chainCode	string	Ya	Kode rantai.
tokenSymbol	string	Ya	Simbol token.
bindKey	string	Ya	Kunci pengikat.
addressId	number	Ya	ID Alamat.
address	string	Ya	Alamat penerima eksklusif.
addressType	string	Ya	Selalu eksklusif.
notifyUrl	string \| null	Ya	URL callback eksklusif yang digunakan oleh binding ini.
status	string	Ya	Mengikat status.

Contoh respons

{
  "bindingId": 70031,
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "bindKey": "USER_90001",
  "addressId": 31088,
  "address": "TQ3sCY8k9h7G9UsApY3JPt5VDpNKr2kJ1E",
  "addressType": "exclusive",
  "notifyUrl": "https://merchant.example.com/api/uugate/member-topup-notify",
  "status": "active"
}

Contoh kode

cURL Contoh Permintaan

curl -X POST 'https://api.uugate.com/openapi/payin/exclusive-bindings' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: mch_xxxxxxxxxxxxxxxxxxxx' \
  -H 'x-merchant-uid: 880001' \
  -H 'x-timestamp: 1776193200000' \
  -H 'x-nonce: 2f5c7b147c3748f0a8b3d9bb38aa91a4' \
  -H 'x-signature: <SIGNATURE_HEX>' \
  -d '{
    "chainCode": "TRON",
    "tokenSymbol": "USDT",
    "bindKey": "USER_90001",
    "label": "VIP User 90001",
    "notifyUrl": "https://merchant.example.com/api/uugate/member-topup-notify"
  }'

Catatan

Jika bindKey yang sama dibuat lagi, platform secara idempoten mengembalikan pengikatan dan alamat yang ada, yang berfungsi dengan baik untuk alur dapatkan atau buat.
Untuk isi ulang anggota, lewati notifyUrl pada waktu yang mengikat sehingga setoran dalam jumlah berapa pun ke alamat eksklusif akan dipanggil kembali langsung ke situs atau aplikasi terkait.