结算回款通知 V2

说明

• 该接口由商户侧实现，Bluepay 在某个结算日对应的交易全部完成结算后，会调用该接口发送通知。
• 对于极兔主子商户模式，Bluepay 只会通知主商户；通知内容通过 settlementDetailList 携带本次涉及的主商户和子商户 appId 及对应交易日期。
• 收到该通知后，可调用 /open-api/report/download 下载最新对账文件压缩包。
• 当前事件名固定为 settle.payment.success。

URL

• 由商户提供

请求方式

• POST

请求头

参数名	必选	类型	说明
Content-Type	是	string	application/json

请求体参数

参数名	必选	类型	说明
param	是	string	参数体
sign	是	string	签名

param参数

参数名	必选	类型	说明
eventName	是	string	事件名称，固定为 settle.payment.success
countryCode	是	string	国家编码，例如 TH
settlementDetailList	是	array[object]	本次通知关联的对账明细列表
settlementDetailList.appId	是	string	商户在 Bluepay 的应用 appId
settlementDetailList.settlementDate	是	string	结算日期，格式 yyyy-MM-dd
settlementDetailList.transDateList	是	array[string]	该 appId 对应的交易日期列表，元素格式 yyyy-MM-dd
notifyTime	是	string	通知发送时间，格式 yyyy-MM-dd HH:mm:ss

请求示例

param 内容

{
  "eventName": "settle.payment.success",
  "countryCode": "TH",
  "settlementDetailList": [
    {
      "appId": "349094b672f347969422ca70123790477a8af",
      "settlementDate": "2026-05-21",
      "transDateList": [
        "2026-05-20"
      ]
    },
    {
      "appId": "sub_app_id_001",
      "settlementDate": "2026-05-21",
      "transDateList": [
        "2026-05-20"
      ]
    },
    {
      "appId": "sub_app_id_002",
      "settlementDate": "2026-05-21",
      "transDateList": [
        "2026-05-19",
        "2026-05-20"
      ]
    }
  ],
  "notifyTime": "2026-05-21 15:39:39"
}

Bluepay 如何构造请求体

请求体

{
  "sign": "V6HQvEZaLF5MSH8TcOVdqPj7fLyvdrAOPm74rW9svpclBIVPlokyiZqPXl09/yAOS8PNnganUtvRvie9MAxJwtYOkDMXxxi4gWjPl3D9L6W4fnVeC28HjhZhWrSgwlecJG6SuHM3odTHAxr5WQUuOxsYFtx+c74Ew+ZzuICCH3dA4+uzNEbDyB8QmBF94nM1LFhDId/VEMxdbj8xKJuOMiSBgwAWaFElm5YCfgmrZpU/qLnuGX2hNxQAMKY2GAw+4VpphYpHG8Xak5+PlqFWKp8mKJ9DgyphVf0ACGpcjOQp0S1V+S1HMMVU0AkW6c8n0weOMu3l6k6cPHsjEe/jSQ==",
  "param": "{\"eventName\":\"settle.payment.success\",\"countryCode\":\"TH\",\"settlementDetailList\":[{\"appId\":\"349094b672f347969422ca70123790477a8af\",\"settlementDate\":\"2026-05-21\",\"transDateList\":[\"2026-05-20\"]},{\"appId\":\"sub_app_id_001\",\"settlementDate\":\"2026-05-21\",\"transDateList\":[\"2026-05-20\"]},{\"appId\":\"sub_app_id_002\",\"settlementDate\":\"2026-05-21\",\"transDateList\":[\"2026-05-19\",\"2026-05-20\"]}],\"notifyTime\":\"2026-05-21 15:39:39\"}"
}

响应参数

参数名	类型	说明
code	integer	响应码，成功固定为 10000
message	string	响应消息，成功固定为 Success

响应示例

{
  "code": 10000,
  "message": "Success"
}

业务说明

• 同一个主商户同一结算日只会在满足条件后推送。
• 当本次通知涉及的主商户和子商户交易都完成结算后，Bluepay 才会发送本通知。
• 收到通知后，应按 settlementDetailList 中的 appId + settlementDate + transDateList 调用 ReportDownload 接口下载最新对账压缩包。
• 若商户侧返回非 200 OK 或响应超时，Bluepay 会按内部重试机制处理。