# 1.4 QR Code 还款通知

# 说明

  • 该接口由商户实现,作用是在商户的 QR Code 发生还款交易时,Bluepay 会调用此接口将还款交易详情通知给商户。

# URL

  • 由商户提供

# 请求方式

  • POST

# 请求头

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

# 请求体参数

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

# 请求参数

参数名 是否必填 类型 说明
eventName 是 string 事件名称( qrcode.payment.success , qrcode.payment.failed )
mchOrderId 是 string 商户订单号
transactionId 是 string Bluepay 流水号
amount 是 integer 金额,多单COD总金额,单位分
fee 是 integer 手续费,单位分
totalAmount 是 integer 总金额(二维码金额),单位分
transactionStatus 是 string 交易状态(PENDING , COMPLETED , FAILED)
createTime 是 string 交易创建时间
returnTime 是 string 交易完成时间
channelCode 是 string 渠道码
remark 是 string 备注
failedCode 否 integer Failed Code
failedMessage 否 string Failed Message

# 响应参数

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

# 请求示例

# param 内容

{
  "channelCode": "THAI_DYNAMIC_QR",
  "mchOrderId": "8880001",
  "transactionId": "QR123456789",
  "amount": 2300,
  "fee": 200,
  "totalAmount": 2500,
  "transactionStatus": "COMPLETED",
  "createTime": "2022-11-28 22:10:10",
  "returnTime": "2022-11-28 22:11:00",
  "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\":200,\"totalAmount\":2500,\"transactionStatus\":\"COMPLETED\",\"createTime\":\"2022-11-28 22:10:10\",\"returnTime\":\"2022-11-28 22:11:00\",\"remark\":\"example\"}"
}

# 返回示例

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