支付结果回传(支付单)
- 接口:common/document/payStatusV3
- Method:PUT
- 数据格式:JSON
- 限流信息:100次每天和50次每小时
- 多语言环境:在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW(繁体),请选取其中一种
- 接口说明:支付结果回传(支付单)
- 其他补充信息:
- 仅可将支付状态从
paying
更新为 paid
或error
的单据
参数:
请求参数
字段名称 |
字段类型 |
字段描述 |
是否必填 |
长度限制(字节) |
bizId |
String |
当前次接口同步的唯一标识 |
TRUE |
36 |
timestamp |
long |
当前次接口同步时间对应的时间戳 |
TRUE |
13 |
data |
JSONObject |
请求数据体 |
TRUE |
无 |
data.document_num |
String |
单据号 |
TRUE |
64 |
data.pay_status |
String |
付款状态(paid, error) |
TRUE |
16 |
data.pay_status_message |
String |
支付信息 |
TRUE |
255 |
data.actual_payment_date |
Date |
支付日期(yyyy-MM-dd HH:mm:ss) |
FALSE |
0 |
返回参数
字段名称 |
字段类型 |
字段描述 |
resCode |
Integer |
响应状态码(见附录) |
resMsg |
String |
返回信息描述 |
示例:
请求数据
{
"bizId": "88dfcfd1-9a43-4315",
"timestamp": 1575859011647,
"data": {
"document_num": "EXP0000000001",
"pay_status": "paid",
"pay_status_message": "支付成功",
"actual_payment_date": "2020-07-01 00:00:00"
}
}
返回数据
{
"resCode":"200000",
"resMsg":"修改成功"
}