付款回调
接口信息
- 路径: 由商户提供
- 方法: POST
- Content-Type: application/json; charset=UTF-8
回调说明
- 回调地址由商户提供
- token(建议生成32位随机字符串)需要商户提供用于校验数据来源
- oneway将在状态生成之后回调
- 只有在接收到商户返回的报文为"SUCCESS"时,才认为商户接收到回调并成功处理
- 否则将按照2小时一次,连续18次进行重试
- 如果始终未成功,通知失败后将不再通知
- 商户可以通过查询获取最新状态
请求参数
Headers
请求头
| 参数名 | 值 | 必填 | 说明 |
|---|---|---|---|
| Content-Type | application/json; charset=UTF-8 | 是 | 请求体类型 |
| Authorization | "Credentials "+token | 是 | token由商户提供,用作数据来源校验 |
Request Body
主要参数
| 参数名 | 类型 | 说明 | 必填 |
|---|---|---|---|
| merchantNo | string | 商户号 | M |
| requestId | string | 商户流水号 | M |
| payoutId | integer | 付款流水ID | M |
| status | string | 状态枚举值 | M |
| statusTime | string | 状态时间 eg:"2025-01-15 08:51:40" | M |
| payoutStatusReason | string | 出款状态原因 | C |
| settleCurrency | string | 付款币种 | M |
| settleSumAmount | number | 付款金额 | M |
| payoutCurrency | string | 到账币种 | M |
| payoutAmount | number | 到账金额 | M |
| serviceFee | number | 手续费 | C |
| convRate | number | 转换汇率 | C |
请求示例
json
{
"merchantNo": "800149",
"requestId": "TX20250115085140001",
"payoutId": 1879088978595545088,
"status": "SUCCESS",
"statusTime": "2025-01-15 08:51:40",
"payoutStatusReason": null,
"settleCurrency": "USD",
"settleSumAmount": 100.00,
"payoutCurrency": "EUR",
"payoutAmount": 92.35,
"serviceFee": 2.50,
"convRate": 0.9235
}响应结果
响应头 Headers
| 参数名 | 值 | 必填 | 说明 |
|---|---|---|---|
| content-type | application/json;charset=UTF-8 | 是 | 响应体类型 |
响应示例
text
SUCCESS