更新支付结果
业务说明
- 调用方调用接口 获取导出中的支付单接口后，通过该接口更新拉取状态。
- 调用方通过第三方支付平台进行支付操作后，调用该接口更新支付状态。
用于更新导出状态或更新支付状态. 状态转换图如下
接口地址
/api/openapi/paymenttransaction/update
请求方式
POST
接口限制
上限50条请求参数说明
参数说明
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| data | object[] | Y | 支付结果数据，上限50条 |
data参数说明
| 参数名称 | 参数值 | 是否必须 | 示例 | 备注 |
|---|---|---|---|---|
| paymentNo | string | Y | 支付流水,不能重复 | |
| status | string | Y | 已导出EXPORTED；导出失败EXPORT_FAILED；支付成功PAY_SUCCESS；支付失败PAY_ERROR；支付失败退回PAY_ERROR_REFUND | |
| paidTime | long | N | 支付成功时必填；支付时间，到毫秒的13位时间戳； | |
| payerAccountNumber | string | N | 支付账号; 支付成功时：如果打开了控制中心的导出至资金平台前指定支付账户开关则必填，且必须与导出时的支付账号一致；如果未开启该开关，则非必需，但是传了支付账号，则会校验传入支付账号的合法性。 |
|
| paymentSystemNumber | string | N | 支付平台的支付流水号，更新为支付成功时才会记录生效。（对应系统的支付单内的“流水号”参数） | |
| errorMsg | string | N | 失败信息; 支付失败时必填 | |
| receiptUrl | string | N | 回单可下载的链接地址。若无回单，后续可以调用附件上传接口 | |
| employeeId | string | N | 员工工号若不填写，则会任选一个该流程节点的员工 |
数据示例
{
"data": [
{
"paymentNo":"1",
"status":"PAY_ERROR",
"errorMsg":"xxxx"
},
{
"paymentNo":"2",
"status":"PAY_SUCCESS",
"paidTime": 1572506924082,
"payerAccountNumber":"xxxx",
"paymentSystemNumber":"xxxxx",
"receiptUrl":"xxxx",
"employeeId":"MK001"
}
]
}
请求响应
参数说明
| 名称 | 类型 | 是否必须 | 备注 | 其他信息 |
|---|---|---|---|---|
| code | string | Y | 返回ACK、NACK、BUSINESS_ERROR | ACK表示接口正常；NACK表示接口异常；BUSINESS_ERROR表示支付结果参数错误, 只会返回错误的数据, 其他会被正确处理, 只要重试返回数据.异常详细信息见data参数 |
| message | string | N | ||
| data | object[] | N | 数据错误提示信息. 对象类型下表 |
errorMsg参数说明
| 名称 | 类型 | 是否必须 | 备注 | 其他信息 |
|---|---|---|---|---|
| no | string | Y | 支付流水, 对应更新支付结构接口中的参数 | |
| message | string | Y | 支付流水对应记录的错误信息 |
响应示例
正常处理时返回
{
"code":"ACK"
}
存在错误支付结果时返回
{
"code": "BUSINESS_ERROR",
"data": [
{
"no": "1",
"message": "缺少失败信息"
}
]
}
支付成功时回写支付成功返回
{
"code": "ACK",
"message": null,
"data": [
{
"no": "FPO2101041K4S5K00",
"message": "该单据已标记支付成功，无需重新标记"
}
],
"errorCode": null,
"success": true
}