Buat pesanan penerimaan

Membuat pesanan pembayaran bersama dengan jumlah tetap. Responsnya meliputi nomor pesanan, alamat penerima, checkout URL, dan pembayaran status.

notifyUrl diperlukan. Panggilan balik selanjutnya untuk pesanan ini dikirimkan langsung ke URL ini.

POST/openapi/payin/orders

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, misalnya USDT.
merchantOrderNo	string	Ya	Nomor pesanan pedagang.
amount	string	Ya	Jumlah pembayaran, hingga 6 tempat desimal.
notifyUrl	string	Ya	Panggilan balik khusus pesanan URL. Direkomendasikan HTTPS URL publik yang dimiliki oleh pedagang.

Contoh permintaan

{
  "chainCode": "TRON",
  "tokenSymbol": "USDT",
  "merchantOrderNo": "M202604150001",
  "amount": "100.00",
  "notifyUrl": "https://merchant.example.com/api/uugate/payin-notify"
}

Kolom respons

Kolom	Tipe	Wajib	Deskripsi
orderNo	string	Ya	Nomor pesanan platform.
merchantOrderNo	string \| null	Ya	Nomor pesanan pedagang.
bindKey	string \| null	Ya	Binding key for exclusive-wallet orders; empty for shared pay-in orders.
amount	string \| null	Ya	Jumlah pesanan.
paidAmount	string \| null	Ya	Jumlah yang dibayarkan. Kosong sebelum pembayaran.
address	string	Ya	Alamat penerima sebenarnya.
cashierUrl	string	Ya	Pembayaran penuh URL.
paymentUri	string	Ya	Pembayaran dompet URI.
expireAt	string \| null	Ya	Waktu kedaluwarsa pesanan.
createdAt	string \| null	Ya	Waktu yang diciptakan.
detectedAt	string \| null	Ya	Payment detection time; empty before detection.
confirmedAt	string \| null	Ya	On-chain confirmation time; empty before confirmation.
completedAt	string \| null	Ya	Order completion time; empty before completion.
status	string	Ya	Pesan status.

Contoh respons

{
  "orderNo": "PI1776193200123ABCD1234",
  "merchantOrderNo": "M202604150001",
  "bindKey": null,
  "amount": "100.000000",
  "paidAmount": null,
  "address": "TXYZ3x9nJ5J4xP2gh6mQW7rT31jB8Y2pA9",
  "cashierUrl": "https://open.uugate.com/SK/PI1776193200123ABCD1234",
  "paymentUri": "TRON:TXYZ3x9nJ5J4xP2gh6mQW7rT31jB8Y2pA9?token=USDT&amount=100.000000",
  "expireAt": "2026-04-18T06:30:00.000Z",
  "createdAt": "2026-04-18T06:00:00.000Z",
  "detectedAt": null,
  "confirmedAt": null,
  "completedAt": null,
  "status": "waiting_payment"
}

Contoh kode

cURL Contoh Permintaan

curl -X POST 'https://api.uugate.com/openapi/payin/orders' \
  -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",
    "merchantOrderNo": "M202604150001",
    "amount": "100.00",
    "notifyUrl": "https://merchant.example.com/api/uugate/payin-notify"
  }'

Catatan

Pesanan pembayaran bersama dapat memicu 40105 ketika pedagang, jaringan, token, dan jumlah yang sama masih dipesan oleh pesanan lain yang valid.