API PAY-OUT TRANSACTION

API pay-out wilayah USDT (USDT). Lihat Payment methods.

Request

API Pay-Out memungkinkan merchant untuk melakukan transaksi pencairan dana (disbursement) ke berbagai penerima, termasuk karyawan, pelanggan, pemasok, dan mitra bisnis. API ini mendukung beberapa metode pembayaran kripto untuk memastikan pemindahan aset digital yang aman dan efisien.

Request Path:

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/disbursement/pay-out
production: https://gateway.smilepayz.com/v2.0/disbursement/pay-out

Header Parameters

Field	Required	Type	Description
Content-Type	M	String	application/json request body.
X-TIMESTAMP	M	String	Datetime with zone offset, format yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	Signature of JSON body (see product Signature doc).
X-PARTNER-ID	M	String	Your merchantID

Body Parameters

Field	Required	Type	Description
orderNo	M	String(32)	Merchant-unique id
purpose	M	String(64)	Memo to payer
merchant	M	Object	Wraps merchantId and optional sub-merchant fields.
merchantId	M	String	Smilepayz merchantId for this call.
merchantName	O	String	Merchant display name.
subMerchantId	O	String	Sub-merchant ID.
subMerchantName	O	String	Name for subMerchantId.
money	M	Object	Currency plus amount for this transaction.
currency	M	String	Fixed to USDT.
amount	M	Number	Amount
paymentMethod	M	String(6)	See Payment methods doc.
cashAccount	M	String(32)	Beneficiary bank account number.
network	M	String(32)	Spesifikasi jaringan blockchain Format: kode jaringan yang sudah ditentukan Contoh: BEP20, TRC20 Menunjukkan jaringan blockchain yang digunakan untuk memproses transaksi
callbackUrl	O	String(256)	HTTPS async status URL, max 256 chars.

Example Body – Disbursement Request:

Content-type: application/json
X-TIMESTAMP: 2020-12-17T10:55:00+07:00
X-SIGNATURE: 7MHd9v5/m9JeqmDZVwWBZUZ5J5...7120QnFEny7Qm7uQR1G0TWCh10fsU6nVxiRoeoQ==
X-PARTNER-ID: 20001

{
  "orderNo": "2000102900000000000001",
  "paymentMethod": "USDT",
  "purpose": "Treasury transfer — TRC20 wallet",
  "cashAccount": "TS8taf44vwibX7z4vE7aqrA7xVQjzzGKoZ",
  "network": "TRC20",
  "merchant": {
    "merchantId": "20001"
  },
  "money": {
    "amount": 100,
    "currency": "USDT"
  }
}

Response

HTTP Response

Field	Required	Type	Description
Content-Type	M	String	application/json response or callback body.
X-TIMESTAMP	M	String	Datetime with zone offset, format yyyy-MM-ddTHH:mm:ss±HH:mm

Body Parameters

Field	Required	Type	Description
code	M	String	00 success, other values error.
message	M	String	UTF-8 human-readable result line.
orderNo	M	String	Merchant-unique id
tradeNo	O	String	Smilepayz tradeNo for this order.
merchant	M	Object	Wraps merchantId and optional sub-merchant fields.
merchantId	M	String	Smilepayz merchantId for this call.
merchantName	O	String	Merchant display name.
subMerchantId	O	String	Sub-merchant ID.
subMerchantName	O	String	Name for subMerchantId.
money	M	Object	Currency plus amount for this transaction.
currency	M	String	Fixed to USDT.
amount	M	Number	Amount
disbursementTime	M	String	Timestamp penyelesaian transaksi pay-out Format: yyyy-MM-ddTHH:mm:ss Contoh: 2020-12-17T10:55:00+07:00 Digunakan untuk pencatatan waktu transaksi dan audit
channel	M	Object	Channel payload (paymentUrl, qrString, …).
status	O	String	Order or payment status enum value.

Content-type: application/json
X-TIMESTAMP: 2020-12-17T10:55:00+07:00

{
    "code": "00",
    "message": "successful",
    "orderNo": "2000102900000000000001",
    "tradeNo": "20001032432400001",
    "merchant": {
        "merchantId": "20001",
        "merchantName": "Smilepayz Demo Store",
        "accountNo": "2000124234782342"
    },
    "money": {
        "currency": "USDT",
        "amount": 100
    },
    "disbursementTime": "2024-12-17T10:55:00+07:00",
    "channel": {
        "paymentMethod": "USDT",
        "cashAccount": "TS8taf44vwibX7z4vE7aqrA7xVQjzzGKoZ",
        "accountName": "Demo Beneficiary"
    },
    "status": "PROCESSING"
}

Notification

HTTP Request

Field	Required	Type	Description
Content-Type	M	String	application/json request body.
X-TIMESTAMP	M	String	Datetime with zone offset, format yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	Callback body signature (see Callback signature guide).

Body Parameters

Field	Required	Type	Description
orderNo	M	String	Merchant-unique id
tradeNo	M	String	Smilepayz tradeNo for this order.
merchantId	M	String	Smilepayz merchantId for this call.
merchantName	M	String	Optional Merchant display name.
subMerchantId	O	String	Sub-merchant ID.
subMerchantName	O	String	Name for subMerchantId.
paymentMethod	M	String	See Payment methods doc.
transactionTime	M	String	Transaction completion timestamp Format: yyyy-MM-ddTHH:mm:ss Example: 2024-12-17T10:55:00 Used for transaction timing and audit
status	M	String	Order or payment status enum value.
money	M	Object	Currency plus amount for this transaction.
currency	M	String	Fixed to USDT.
amount	M	Number	Amount

Return

Important Response

Notification Response: Harap kembalikan hanya string SUCCESS untuk mengonfirmasi bahwa notifikasi telah diterima dengan benar oleh sistem Anda

{
  "orderNo": "2000102900000000000001",
  "tradeNo": "20001032432400001",
  "merchantId": "20001",
  "merchantName": "Smilepayz Demo Store",
  "subMerchantId": "",
  "subMerchantName": "",
  "paymentMethod": "USDT",
  "transactionTime": "2024-12-17T10:55:00+07:00",
  "money": {
    "currency": "USDT",
    "amount": 100
  },
  "status": "SUCCESS"
}

SUCCESS