创建出款单（沙特）
创建沙特里亚尔（SAR）出款订单接口，支援 IBAN 银行转账与 STC Pay / urpay / Barq 钱包。
请求资讯
- 请求 URL：
/gateway/api/v2/payouts - 请求方式：
POST - Content-Type：
application/json;charset=utf-8
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| platform_id | 是 | String(6) | 商户 ID |
| service_id | 是 | String(7) | 服务 ID，固定值 SVC0004 |
| payout_cl_id | 是 | String(64) | 商户订单号 |
| amount | 是 | Integer(10) | 金额（哈拉拉） |
| notify_url | 否 | String(256) | 交易结果通知地址 |
| bank_name | 是 | String(16) | 银行/钱包代码，亦可传银行英文名称，银行列表 |
| name | 是 | String(64) | 受款人户名 |
| number | 是 | String(64) | 受款人帐号：银行转账传 IBAN，钱包传钱包帐号 |
| iban | 条件 | String(34) | 沙特 IBAN（SA 开头共 24 码）。银行转账必填；未传则以 number 进行 IBAN 校验 |
| phone_number | 条件 | String(11) | 受款人手机号（如 0512345678）。银行转账必填；钱包未传时以 number 代替 |
| currency | 是 | String(3) | 固定值：sar |
| request_time | 是 | Integer(10) | 请求时间（秒） |
| sign_type | 否 | String(16) | 签名类型，固定值 HMAC-SHA256 |
| sign | 是 | String(32|64) | 订单签名 |
「条件」表示视收款方式而定，详见下方备注。
服务 ID
SVC0004银行卡出款（以bank_name区分银行转账或钱包）
返回示例
{
"error_code": "0000",
"data": { "payout_id": "POT00000001" }
}
备注
重要提示
如遇超时或 HTTP 500 错误，请以订单查询接口状态为依据，不可直接视为订单失败。
- 交易金额单位为沙特里亚尔（哈拉拉）
- 银行转账：
bank_name传银行代码或英文行名，iban须为合法沙特 IBAN（SA+ 22 码），phone_number必填 - 钱包（STC Pay / urpay / Barq）：
bank_name传STC、URPAY或BARQ，number传钱包帐号（即手机号） - 收款资讯校验不通过时于建单阶段即返回错误，不会产生订单
- 返回 "0000" 仅代表接口调用成功，请调用查询接口确认结果
- 单笔金额限制以商务确认为准