数据同步
支付账单查询接口
此接口支持商户端通过条件查询支付结果。荣e通根据查询条件实时返回该订单支付相关数据
请求地址
| 环境 | 请求地址 |
| 正式环境 | https://api.cargonpay.com/api/apiJoinPay/paymentbillquery |
请求参数
| 索引 | ID | 名称 | 长度 | 必须 | 说明 |
| 1 | accessKey | 请求唯一标识 | varchar(36) | 是 | |
| 2 | nonce | 随机号 | varchar(36) | 是 | |
| 3 | timestamp | 时间戳 | varchar(20) | 是 | Unix时间戳，保留到毫秒 |
| 4 | sign | 签名 | varchar(32) | 是 | |
| 5 | billDate | 账单日期 | varchar(10) | 是 | 格式：yyyy-MM-dd |
响应参数
| 索引 | ID | 名称 | 长度 | 必须 | 说明 |
| 1 | code | 返回状态码 | varchar(10) | 是 | |
| 2 | message | 返回消息 | varchar(200) | 是 | |
| 3 | data | array | 是 | ||
| 4 | merchantOrderNo | 商户订单号 | nvarhcar(36) | 是 | |
| 5 | orderPaymentState | 订单支付状态 | int | 是 | |
| 6 | orderAmount | 订单支付总金额 | decimal(18,2) | 是 | |
| 7 | billNo | 提单号 | varchar(200) | 是 | |
| 8 | paymentOpeningBankName | 付款开户行名称 | varchar(100) | 是 | |
| 9 | paymentBankName | 付款银行名称 | varchar(50) | 是 | |
| 10 | paymentBankAccount | 付款银行账号 | varchar(30) | 是 | |
| 11 | invoice | 发票信息 | array | ||
| 12 | invoiceNo | 发票号码 | varchar(10) | 是 | 币别为USD时必填，为CNY时选填 |
| 13 | invoiceType | 发票类型 | varchar(10) | 是 | 币别为USD时必填，为CNY时选填 |
| 14 | invoicePaymentState | 发票支付状态 | int | 是 | |
| 15 | invoicePaymentMsg | 发票支付结果 | varchar(200) | 是 | |
| 16 | invoicePaymentAmount | 发票支付金额 | decimal(18,2) | 是 | |
| 17 | receiptOpeningBankName | 收款开户行名称 | varchar(100) | 是 | |
| 18 | receiptBankAccount | 收款银行账号 | varchar(30) | 是 | |
| 19 | bankOrderCode | 银行订单号 | varchar(32) | 是 | 仅中行发起支付时返回 |
| 20 | paySeqNo | 支付流水号 | varchar(32) | 是 | 仅中行发起支付时返回 |
请求示例
JSON格式
- {
- "timestamp": "1725797231000",
- "nonce": "1725797231016",
- "accessKey": "F0D16DD2EFF945C4B73A4B37F99C2696",
- "sign": "91A6A4104B312E0DC321A41964C54F76",
- "billDate": "2021-07-09"
- }
复制代码
响应示例
JSON格式
{
"code": "000000",
"message": "请求成功",
"data": [
{
"merchantOrderNo": "8192389919",
"orderPaymentState": 1,
"orderAmount": 10780,
"billno": "871283718",
"paymentOpeningBankName": "中国银行天津市分行",
"paymentBankName": "中国银行",
"paymentBankAccount": "273985618448",
"invoice": [
{
"receiptBankAccount": "32423423423423",
"receiptOpeningBankName": "中国银行合肥支行",
"invoiceType": "PDF",
"orderCode": "R21070916290210262",
"invoicePaymentAmount": 6900,
"invoiceNo": "47120419",
"invoicePaymentState": 3,
"invoicePaymentMsg": "发票重复支付"，
"bankOrderCode": "32423423423423",
"paySeqNo": "32423423423423"
}
]
}
]
}
复制代码
查询返回状态码
| 索引 | ID | 名称 |
| 1 | 000000 | 提交成功 |
| 2 | 100001 | 参数无效，【参数名】不正确 |
| 3 | 100002 | 请求时间超出有效时间 |
| 4 | 100003 | 商户accessKey不存在，请联系荣e通客服 |
| 5 | 100004 | 商户accessKey已停用 |
| 6 | 100005 | 验证签名失败 |
| 7 | 100006 | 请求重复，请重新发起(nonce重复) |
| 8 | 200006 | 暂无符合条件数据 |
| 9 | 999999 | 系统错误，请联系技术人员 |
订单支付状态
| 索引 | ID | 名称 |
| 1 | 0 | 未付 |
| 2 | 1 | 支付处理中 |
| 3 | 2 | 支付成功 |
| 4 | 3 | 支付失败 |
| 5 | 4 | 部分成功 |
订单支付状态
| 索引 | ID | 名称 |
| 1 | 0 | 未付 |
| 2 | 1 | 支付处理中 |
| 3 | 2 | 支付成功 |
| 4 | 3 | 支付失败 |
- 请求地址
- 请求参数
- 响应参数
- 请求示例
- 响应示例
- 返回码说明
- 订单支付状态
- 发票支付状态
