創建出款單（人民幣-銀行卡）
創建人民幣（CNY）銀行卡代付訂單接口。
請求資訊
- 請求 URL：
/gateway/api/v2/payouts - 請求方式：
POST - Content-Type：
application/json;charset=utf-8
請求參數
| 參數名 | 必選 | 類型 | 說明 |
|---|---|---|---|
| platform_id | 是 | String(7) | 商戶 ID |
| service_id | 是 | String(7) | 服務 ID，請填入固定值 SVC0004 |
| payout_cl_id | 是 | String(32) | 商戶訂單號 |
| amount | 是 | Integer(10) | 金額（分） |
| notify_url | 否 | String(256) | 交易結果通知地址 |
| bank_name | 是 | String | 銀行名稱，銀行列表 |
| name | 是 | String | 受款人戶名 |
| number | 是 | String | 受款人帳號 |
| bank_branch | 否 | String | 支行名 |
| province | 否 | String | 省份 |
| city | 否 | String | 城市 |
| request_time | 是 | Integer(10) | 請求時間（秒） |
| sign | 是 | String(32) | 訂單簽名 |
請求示例
{
"amount": "50000",
"bank_name": "中国农业银行",
"name": "test_name",
"notify_url": "https://xxx.xx/notification",
"number": "test",
"payout_cl_id": "DEVPOT00143538",
"platform_id": "PF0002",
"request_time": "1595504997",
"service_id": "SVC0004",
"sign": "8ac38fb87c2bcce4cf36627d4f8aa747"
}
返回示例
成功返回
{
"error_code": "0000",
"data": {
"payout_id": "POT00000001"
}
}
錯誤返回示例
{
"error_code": "0004",
"error_msg": "验签错误!"
}
返回參數說明
| 參數名 | 類型 | 說明 |
|---|---|---|
| error_code | String | 錯誤碼 |
| error_msg | String | 錯誤訊息（error_code 不為 "0000" 時返回） |
| payout_id | String | 平台訂單號 |
備註
重要提示
因為存在網絡波動、併發量過大、被攻擊等不可抗力因素，如若在調用代付接口時遇到 超時、HTTP 500 錯誤、調用結果返回空白，或網絡延遲時，請以 訂單查詢接口狀態 為依據，或與運營人員取得聯繫，提供商戶單號進行人工查詢，由運營人員人工確認代付訂單是否失敗。 未經過運營人員人工確認就駁回代付訂單所造成的損失，本平台概不負責！
- 商戶 ID 為系統分配之唯一識別，如尚未取得請聯繫系統人員
- 服務 ID 請填入
SVC0004（銀行卡代付） - 交易金額單位為人民幣（分）
- 請求時間使用 Unix timestamp，單位為秒
- 返回 "0000" 時僅代表接口調用成功，並不表示交易狀態，請調用查詢接口確認結果
- 如遇任何情況未取得 Server 回應（e.g. 5xx HttpStatus...），需調用查詢接口或等待回調，不可直接視為訂單失敗