# 结算回款通知

# 说明

  • 该接口由商户实现,作用是在商户交易结算完成时,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"
}