Skip to content

付款回调

接口信息

  • 路径: 由商户提供
  • 方法: POST
  • Content-Type: application/json; charset=UTF-8

回调说明

  • 回调地址由商户提供
  • token(建议生成32位随机字符串)需要商户提供用于校验数据来源
  • oneway将在状态生成之后回调
  • 只有在接收到商户返回的报文为"SUCCESS"时,才认为商户接收到回调并成功处理
  • 否则将按照2小时一次,连续18次进行重试
  • 如果始终未成功,通知失败后将不再通知
  • 商户可以通过查询获取最新状态

请求参数

Headers

请求头
参数名必填说明
Content-Typeapplication/json; charset=UTF-8请求体类型
Authorization"Credentials "+tokentoken由商户提供,用作数据来源校验

Request Body

主要参数

参数名类型说明必填
merchantNostring商户号M
requestIdstring商户流水号M
payoutIdinteger付款流水IDM
statusstring状态枚举值M
statusTimestring状态时间 eg:"2025-01-15 08:51:40"M
payoutStatusReasonstring出款状态原因C
settleCurrencystring付款币种M
settleSumAmountnumber付款金额M
payoutCurrencystring到账币种M
payoutAmountnumber到账金额M
serviceFeenumber手续费C
convRatenumber转换汇率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-typeapplication/json;charset=UTF-8响应体类型

响应示例

text
SUCCESS