# 结算回款通知

# 说明

  • 该接口由商户实现,作用是在商户交易结算完成时,Bluepay 会调用此接口将还款交易详情通知给商户。

# URL

  • 由商户提供

# 请求方式

  • POST

# 请求头

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

# 请求体参数

参数名 必选 类型 长度限制 示例 说明
param 是 string - - 参数体
sign 是 string - - 签名

# 请求参数

参数名 是否必填 类型 说明
eventName 是 string 事件名称( settle.payment.success )
mchOrderId 是 string 商户订单号
transactionId 是 string Bluepay 流水号
amount 是 integer 交易金额,单位分
fee 是 integer 交易手续费,单位分
settledReturnTime 是 string 结算完成时间
channelCode 是 string 渠道码
projectType 否 string 项目类型, PPCASH,VIP,HOME (这里目前授权代扣回款没有类型)
remark 否 string 备注

# 响应参数

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

# 请求示例

# param 内容

{
  "channelCode": "THAI_DYNAMIC_QR",
  "eventName": "settle.payment.success",
  "mchOrderId": "8880001",
  "transactionId": "QR123456789",
  "amount": 2300,
  "fee": 0,
  "projectType": "PPCASH",
  "settledReturnTime": "2022-11-28 22:10:10",
  "remark": "example"
}

Bluepay 如何构造请求体

# 请求体

{
  "sign": "V6HQvEZaLF5MSH8TcOVdqPj7fLyvdrAOPm74rW9svpclBIVPlokyiZqPXl09/yAOS8PNnganUtvRvie9MAxJwtYOkDMXxxi4gWjPl3D9L6W4fnVeC28HjhZhWrSgwlecJG6SuHM3odTHAxr5WQUuOxsYFtx+c74Ew+ZzuICCH3dA4+uzNEbDyB8QmBF94nM1LFhDId/VEMxdbj8xKJuOMiSBgwAWaFElm5YCfgmrZpU/qLnuGX2hNxQAMKY2GAw+4VpphYpHG8Xak5+PlqFWKp8mKJ9DgyphVf0ACGpcjOQp0S1V+S1HMMVU0AkW6c8n0weOMu3l6k6cPHsjEe/jSQ==",
  "param": "{\"channelCode\":\"THAI_DYNAMIC_QR\",\"mchOrderId\":\"8880001\",\"transactionId\":\"QR123456789\",\"amount\":2300,\"fee\":0,\"projectType\":\"PPCASH\"\"settledReturnTime\":\"2022-11-28 22:10:10\",\"remark\":\"example\"}"
}

# 返回示例

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