# 4. QR Code Payment Notification
# Descrption
This interface should be implemented by merchant. The function is that when a payment transaction occurs on the merchant's QR Code, BluePay will call this interface to notify the merchant of the payment transaction details.
# HTTP request info
# URL
Provided by merchant.
# Method
POST
# Content-Type
application/json
# Request parameters
parameter name | required | type | description |
---|---|---|---|
eventName | Yes | string | event name( qrcode.payment.success , qrcode.payment.failed ) |
mchOrderId | Yes | string | merchant order ID, alphanumeric, max length 32 |
transactionId | Yes | string | BluePay transaction ID |
amount | Yes | integer | amount |
transactionStatus | Yes | string | transaction status(PENDING , COMPLETED , FAILED ) |
createTime | Yes | string | payment create time |
returnTime | Yes | string | payment finish time |
channelCode | Yes | string | channel code, refer to QR Channel List |
remark | Yes | string | remark |
failedCode | No | integer | failed code |
failedMessage | No | string | failed message |
# Response parameters
parameter name | type | description |
---|---|---|
code | integer | Response code, fixed value 10000 |
message | string | Response message, fixed value Success |
# Request example
# Param content
{
"channelCode": "THAI_DYNAMIC_QR",
"transactionId": "QR123456789",
"amount": 2300,
"transactionStatus": "COMPLETED",
"createTime": "2022-11-28 22:10:10",
"returnTime": "2022-11-28 22:11:00",
"remark": "example"
}
How BluePay construct request body
# Request body
{
"sign": "V6HQvEZaLF5MSH8TcOVdqPj7fLyvdrAOPm74rW9svpclBIVPlokyiZqPXl09/yAOS8PNnganUtvRvie9MAxJwtYOkDMXxxi4gWjPl3D9L6W4fnVeC28HjhZhWrSgwlecJG6SuHM3odTHAxr5WQUuOxsYFtx+c74Ew+ZzuICCH3dA4+uzNEbDyB8QmBF94nM1LFhDId/VEMxdbj8xKJuOMiSBgwAWaFElm5YCfgmrZpU/qLnuGX2hNxQAMKY2GAw+4VpphYpHG8Xak5+PlqFWKp8mKJ9DgyphVf0ACGpcjOQp0S1V+S1HMMVU0AkW6c8n0weOMu3l6k6cPHsjEe/jSQ==",
"param": "{\"channelCode\":\"THAI_DYNAMIC_QR\",\"transactionId\":\"QR123456789\",\"amount\":2300,\"transactionStatus\":\"COMPLETED\",\"createTime\":\"2022-11-28 22:10:10\",\"returnTime\":\"2022-11-28 22:11:00\",\"remark\":\"example\"}"
}
# Response example
{
"code": 10000,
"message": "Success"
}