支付回调
当用户支付完成时云城会将支付结果回调给业务方
1.接口说明
支付回调,支付中心对商户的支付请求数据处理完成后,会将处理的结果数据(成功才通知,失败和异常不通知)通过服务器主动通知的方式通知给商户的通知地址,此地址就是提现请求时的 notify_url。通知机制为:总共通知 16 次,直到通知被商户成功接受为止,如果通知 16 次后也没有被商户接受成功则不再发通知,由商户通过提现结果查询接口进行查询。
2.业务时序图
3.接口定义
path | 请求方式 | 接口描述 | 调用权限 |
---|---|---|---|
由业务系统提供 | POST | 支付回调 | N/A |
4.请求头说明
名称 | 是否必须 | 类型 | 默认值 | 备注 |
---|---|---|---|---|
Content-Type | true | string | application/json | N/A |
5.请求参数说明
名称 | 是否必须 | 类型 | 默认值 | 备注 |
---|---|---|---|---|
paymentOrderNo | true | string | N/A | 支付单号 |
tradeOrderNo | true | string | N/A | 业务订单号 |
channelCode | true | string | N/A | 渠道编码 |
amount | true | decimal | N/A | 订单支付金额 |
status | true | string | N/A | 订单支付状态:0(待付款)、1(已付款)、2(部分退款)、3(已退款)、4(支付失败)、5(待确认) |
sign | false | string | N/A | 签名 |
settleDate | false | string | N/A | 结算时间,格式:yyyyMMdd |
successDate | false | string | N/A | 支付成功时间,格式:yyyyMMddHHmmss |
signType | false | string | N/A | 签名类型:MD5, RSA |
请求示例:
{
"paymentOrderNo": "PAY201906059985220003",
"tradeOrderNo": "2019060545621000002",
"channelCode": "CNN",
"amount": 9.99,
"status": 1,
"sign": "6da37dd3139aa4d9a",
"settleDate": "20190908",
"successDate": "20190809",
"signType": "MD5"
}
6.返回参数说明
名称 | 是否必须 | 类型 | 备注 |
---|---|---|---|
body | true | string | 回调结果确认值 |
返回示例: "0000"