回调
接口描述:
由调用方在下单时传递回调地址参数 cbkUrl,支付成功或失败后,支付服务发起调用告知调用方订单的支付结果,支付中不通知。
支付服务收到 HTTP 状态为 200,停止调用;否则,将会在 130 秒内每 3 秒调用一次。
如果调用方 10 秒内没有及时响应,支付服务将会再次发起调用。
请求方式:POST
consumes:["application/json"]
produces:["*/*"]
请求示例:
{
"currency": "CNY",
"amount": 0,
"refund": 0,
"canceled": 0,
"sn": "",
"originalSN": "",
"bankSN": "",
"callerSN": "",
"terminalSN": "",
"payType": "",
"notes": "",
"qrCord": "",
"payTime": "",
"expiryTime": "",
"createTime": "",
"batch": "",
"type": "",
"id": 0,
"remark": "",
"payload": "",
"state": "",
"message": ""
}
请求参数:
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
currency | 货币 | string | |
amount | 金额,单位:元 | number | |
refund | 退费金额,单位:元 | number | |
canceled | 撤单金额,单位:元 | number | |
sn | 流水号 | string | |
originalSN | 原单流水号,退费时记录原支付流水号 | string | |
bankSN | 支付渠道流水号,如:各个银行流水号或业务主键 | string | |
callerSN | 调用方流水号,如:HIS 流水号 | string | |
terminalSN | 终端流水号,如:POS 机流水号/凭证号(建行 OCX 返回) | string | |
payType | 支付方式,参见: 支付方式代码 | string | |
notes | 交易标题、描述或说明 | string | |
qrCord | 支付码 | string | |
payTime | 支付时间 | string(date-time) | string(date-time) |
expiryTime | 失效时间 | string(date-time) | string(date-time) |
createTime | 创建时间 | string(date-time) | string(date-time) |
batch | 批次/账期 | string | |
type | 订单类型,0:支付;1:退费;2:撤单 | string | |
id | 标识,修改时必须 | integer(int32) | integer(int32) |
remark | 备注/描述 | string | |
payload | 负载的其它业务数据, JSON 格式 | string | |
state | 支付状态,1:初始化、2:交易中、3:成功、4:失败 | string | |
message | 消息 | string |
响应状态:
状态码 | 说明 | schema |
---|---|---|
200 | OK | |
201 | Created | |
401 | Unauthorized | |
403 | Forbidden | |
404 | Not Found |