出款交易结果通知
系统将交易结果发送至商户提供的回调地址。
请求资讯
- 请求 URL: 商户于申请出款时填入的
notify_url地址 - 请求方式:
POST - Content-Type:
application/json;charset=utf-8
请求参数
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| payout_id | 是 | String | 系统订单号 |
| payout_cl_id | 是 | String | 商户订单号 |
| platform_id | 是 | String | 商户号 |
| amount | 是 | Integer | 订单金额(分) |
| fee | 是 | Integer | 手续费 |
| status | 是 | Integer | 交易状态 |
| error_msg | 否 | String | 失败原因 |
| create_time | 是 | Integer | 创建时间(秒) |
| update_time | 是 | Integer | 更新时间(秒) |
| sign_type | 否 | String | 签名类型:HMAC-SHA256 或 MD5(仅 HMAC-SHA256 订单返回) |
| sign | 是 | String | 订单签名 |
请求示例
{
"payout_id": "POT00000102",
"payout_cl_id": "97a968b4a9db497c8c03198e395a38c6",
"platform_id": "PF0014",
"amount": 400000,
"fee": 3200,
"status": 3,
"create_time": 1567614049,
"update_time": 1567614111,
"sign": "d2e4534fce8c1d1053bbf59fd8ae4464"
}
商户返回
{ "error_code": "0000" }
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| error_code | String | 返回 "0000" 即表示平台已处理完成 |
备注
- 此接口由商户实现,本系统将于订单成功/取消/失败时消费此接口
- 订单完成起一小时内,将重复通知十次,期间商户返回成功便停止通知
- 建议商户实现验签流程,以确认内容没被篡改
- 此接口可能被重复通知,商户需自行判断是否执行业务逻辑
- 订单状态请参考:订单状态
- 未来可能支持更多字段,串接时请动态取得有返回值的字段并产生签名校验,切勿将字段写死