入参列表
请求参数 | 描述 | 类型 | 是否必须传入 |
customerId | 支付平台分配给开发者的业务id | string | 是 |
txIds | 支付平台订单 id | string | txIds、orderIds 二选一, 优先 txIds,多个id英文半角逗号分隔 |
orderIds | 业务订单id | string | txIds、orderIds 二选一, 优先 txIds,多个id英文半角逗号分隔 |
timestamp | 请求时间戳 毫秒级 | Int | 是 |
traceId | 请求标识id | string | 是 |
version | 接口版本,目前1.0 | string | 是 |
signType | 签名校验类型,默认MD5 | string | 是 |
sign | 校验签名 | string | 是 |
返回列表
【errno及msg映射】
errno | Msg |
0 | Success |
8004010001 | 签名不正确 |
8004010002 | customerId参数为空 |
8004010003 | 参数错误 |
8004010004 | 内部错误 |
8004010005 | timestamp参数为空 |
【data返回体】
返回字段 |
子参数 |
描述 |
traceId |
无 |
请求标识id |
serverTime |
无 |
服务器时间戳 |
customerId |
无 |
业务方id,备注:查询订单会返回所有支付流水订单,如用户发生支付行为,支付平台会保证同时仅有一笔订单状态为支付成功。业务查单时,当列表中有一笔流水单成功视为支付成功,其他情况视为未支付成功。 |
orders |
txId |
支付平台支付id |
orderId |
业务方订单id |
deviceType |
支付设备渠道类型, 1 pc 2 webapp 3 app |
payStatus |
支付状态:PAYING(未支付),OVERDUE(已过期),CLOSED(支付关闭),FAIL(支付失败),SUCCESS(支付成功),FINISHED(交易成功),PAY_SUCCESS_AND_CANCEL(支付成功并且已取消)、PAY_CANCEL(已取消) |
payStatusDesc |
支付状态描述 |
failReason |
支付失败原因 |
payChannel |
支付渠道,alipay(支付宝)、wechat(微信) ,paypal(paypal), iap(In App Purchase)、qpay(QQ支付)、huabei(花呗支付)、wechat_withholding(微信代扣)、alipay_withholding(支付宝代扣)、ali_bank(网银支付)、bocom(交行信用卡支付) |
payAmout |
支付金额,单位分 |
payMsgContent |
支付返回的额外信息,json格式字符串,比如:payCounponAmount:使用B币券金额(单位 分),payBpAmount:B币金额(分) 备注:历史订单和未支付成功订单,返回内容可能为空json字符串 "{}" |
extData |
支付附加信息json串 |
orderPayTime |
支付时间 |
orderCloseTime |
订单关闭时间 |
返回示例
{
"errno": 0,
"msg": "SUCCESS",
"data": {
"traceId": "",
"serverTime": 1387,
"customerId": 1,
"orders": [
{
"txId": "234324324",
"orderId": "12344",
"deviceType": 3,
"payStatus": "SUCCESS",
"payStatusDesc": "支付成功",
"failReason": "",
"payChannel": "alipay",
"payAmout": 100,
"extData": "{}",
"orderPayTime": 1344343,
"orderCloseTime": 13443431,
}
]
}
}