Invalidate QR

Invalidate QR for MPM

Use this endpoint to invalidate the payment reference id in a payment code for Merchant Presented Mode (MPM) if the order in the merchant's system is closed/canceled. Once the QR is invalidated successfully, the corresponding QR code containing the payment reference ID can no longer be used to make payment.

  • URL: "/v3/merchant-host/qr/invalidate"

Request Parameters

FieldTypeMandatoryDescription
request_idstringYUnique identifier for request, accepts up to 64 characters.
payment_reference_idstringYPayment reference ID that corresponds to the QR being invalidated.
merchant_ext_idstringYUnique identifier of merchant in merchant’s system.
store_ext_idstringYUnique identifier of store in merchant’s system.

Sample API Request

REQUEST

{
"request_id": "input-unique-request-id-here",
"payment_reference_id": "ref-must-be-unique",
"merchant_ext_id": "external-merchant",
"store_ext_id": "external-store"
}
arrow-svg

Copy

Response Parameters

FieldTypeDescription
request_idstringUnique identifier for request.
errcodeint32Error code to specify the error returned.
debug_msgstringDebug message to provide more information.

Sample API Response

RESPONSE

{
"request_id": "input-unique-request-id-here",
"errcode": 0,
"debug_msg": "success"
}
arrow-svg

Copy

Response Code

ValueDescription
-2A server dropped the connection
-1A server error occurred
0Success
1The request parameters is invalid or a mandatory parameter is empty
2Permission denied, often due to invalid status
4Not found, often due to merchant/store/user/transaction not found
1800A server error occurred
1901QR code cannot be invalidated