DuitNow QR Account Enquiry Notify

DuitNow QR account enquiry is a functionality that allows DuitNow - supported banks and wallets to verify the validity of a QR code with the QR issuer. Merchants can request to enable the notification feature, which alerts them when the generated QR code has been scanned by the user. This webhook will use the same URL as the payment notification and deliver the information directly to the merchant. The integration for this feature can refer Notification URL with IPN.


Notification Parameters (via POST method)

Variable / ParameterType Format / Max LengthDescription / Example
nbcb1 digit numericAlways equal to 2, which indicates this is a notification from PG.
amount2 decimal points numeric valueThe total amount to be paid for the payment request
orderidalphanumeric, 40 charactersInvoice or order number from merchant system
tranIDinteger, 10 digitsUnique transaction ID for tracking purpose
domainalphanumeric, 32 charsMerchant ID in PG system
status2-digit numeric value22 for Pending payment
appcodealphanumeric, 16 charsBank approval code. Mandatory for card payment. Certain channels return empty value.
error_codealphanumericRefer to the Error Codes section.
error_desctextError message or description.
skey32 chars hexadecimal stringThis is the data integrity protection hash string. Refer skey section for details.
currency2 or 3 chars (ISO-4217) currency codeDefault currency is MYR (indicating Malaysia Ringgit) for Malaysia channels
channelpredefined string in systemChannel references for merchant system
paydateDate/Time (YYYY-MM-DD HH:mm:ss)Date/Time of the transaction.
extraP*optional (on request)

Example: {"account_enquiry":"true","enquirydate":"2023-12-12 12:12:12"}