創建代付訂單
創建一個新的代付(付款)訂單。
請求資訊
| 項目 | 值 |
|---|---|
| 方法 | POST |
| 路徑 | /gateway/api/v1/payouts |
| Content-Type | application/json |
請求參數
| 參數名 | 類型 | 必填 | 說明 |
|---|---|---|---|
platform_id | string | ✅ | 平台商戶 ID |
service_id | string | ✅ | 服務類型 |
merchant_order_id | string | ✅ | 商戶訂單號 |
amount | number | ✅ | 付款金額 |
bank_code | string | ✅ | 銀行代碼 |
card_no | string | ✅ | 收款銀行卡號 |
card_holder | string | ✅ | 持卡人姓名 |
notify_url | string | ✅ | 回調通知 URL |
sign | string | ✅ | 簽名 |
請求範例
{
"platform_id": "10001",
"service_id": "CN_BANK_WITHDRAW",
"merchant_order_id": "PAYOUT_20231218_001",
"amount": 500.00,
"bank_code": "ICBC",
"card_no": "6222021234567890123",
"card_holder": "張三",
"notify_url": "https://your-domain.com/api/payout/callback",
"sign": "a1b2c3d4e5f6..."
}
響應範例
{
"code": 0,
"message": "success",
"data": {
"order_id": "DW20231218123456789",
"status": "PROCESSING",
"status_code": 0
}
}