创建出款单（泰国）
创建泰铢（THB）出款订单接口。
请求资讯
- 请求 URL：
/gateway/api/v2/payouts - 请求方式：
POST - Content-Type：
application/json;charset=utf-8
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| platform_id | 是 | String(6) | 商户 ID |
| service_id | 是 | String(7) | 服务 ID |
| payout_cl_id | 是 | String(64) | 商户订单号 |
| amount | 是 | Integer(10) | 金额（分） |
| notify_url | 否 | String(256) | 交易结果通知地址 |
| bank_name | 是 | String(45) | 银行代码，银行列表 |
| name | 是 | String(64) | 受款人户名（2 ~ 64 字元）。泰国个人与法人户名普遍超过 16 字元，请勿截断 |
| number | 是 | String(64) | 受款人帐号（5 ~ 64 字元） |
| user_id | 否 | String(32) | 商户端用户/会员标识，仅存储用于商户内部对账，不在查询与回调中返回 |
| currency | 是 | String(3) | 固定值：thb。此字段必传——缺少时系统会将订单视为人民币代付，导致路由失败 |
| request_time | 是 | Integer(10) | 请求时间（秒） |
| sign_type | 否 | String(16) | 签名类型，固定值 HMAC-SHA256 |
| sign | 是 | String(32|64) | 订单签名 |
服务 ID
SVC0004银行卡代付
SVC0004为多国共用的代付服务，币别由currency字段决定。
返回示例
{
"error_code": "0000",
"data": { "payout_id": "POT00000001" }
}
备注
重要提示
如遇超时或 HTTP 500 错误，请以订单查询接口状态为依据，不可直接视为订单失败。
- 交易金额单位为泰铢（分）
- 返回 "0000" 仅代表接口调用成功，请调用查询接口确认结果
payout_id格式为{环境标识}POT{8 位数字}，环境标识由系统分配、长度不固定。请以字符串完整保存，勿写死长度或前缀bank_name必须是已开通的银行，否则返回0053（不支持此银行）。银行列表为系统支持的全集，实际可用范围请向商务确认- 单笔金额上下限依商户开通条件而定，超出范围时返回
0028（低于最小限额）/0029（高于最高限额）