Understanding DuitNow QR Payment in ClassicPOS

Understanding DuitNow QR Payment in ClassicPOS

Introduction

This document introduces the DuitNow QR payment feature available in the Xilnex Retail POS, enabling merchants to accept payments conveniently through Malaysia's national QR payment standard.
The integration of DuitNowQR simplifies the payment process for merchants and customers alike—offering faster checkout, reduced cash handling, and broad payment acceptance under a single QR.
This document will help you understand:
  • The transaction flow from QR display to payment confirmation to sales completion
  • Action to be done during fail scenario
  • Operational behavior during online and offline scenarios

Transaction flow in POS

The process flow is applicable for both Retail Point Of Sale and F&B Point Of Sale in Xilnex.

  1. Pay using DuitNowQR

      In order to start the DuitNowQR process flow, press the DuitNowQR payment method during the payment process.
  1. In Retail Point Of Sale


  2. In F&B Point Of Sale


  1. Display of DuitNowQR

      After pressing the DuitNowQR button, the QR will be displayed on the screen. During this screen, customers can start to scan and make payments.
      

  1. Recheck Status function

      After processing for 20 seconds, POS will display the Recheck Status button to let user able manual check status instead of waiting for the completion signal.
      

  1. Completion process

      When receive complete signal from server, Xilnex POS will auto complete the sales and proceed to print receipt.
      

  1. Timeout of the processing

      After 40 seconds of processing time, Xilnex POS will stop displaying the DuitNowQR, but we will remain listening to the signal of completion on the processing screen.
  • Close: cashiers can close the processing screen after 40s of processing time. After the process screen is closed, Xilne POS will be unable to listen to any completion signal from payment gateway.
  • Recheck Status: cashiers are still able to use the button to check the payment status manually.
  • Force Complete: this is the button to let cashiers manually complete the sales without the completion signal.
    • There will be payment remarks as "Force Complete" for reference in payment record.
    • Normally, it is only used when unable to auto complete and customers show payment successfully from their ewallet application.


  1. Additional recheck status handling

  • Recheck status for previous DuitNowQR in same sales
    • Xilnex Retail POS implemented a process to recheck previous DuitNowQR payment status when cashiers generated a new DuitNowQR payment in the same sales.
    • This is to prevent scenario where customers already scan first generated QR and make payment successful.
    • Xilnex POS will verify the received amount for the previous QR before completing sales. When the amount is not tally with existing sales, Xilnex POS will stop complete and continue to generate new DuitNowQR.

Additional note

Do's:

  1. Ensure Active Network Connectivity
    1. Stable connectivity ensures real-time communication with the payment gateway and accurate transaction status updates.
  2. Validate Payment Status Before Force Complete the Bill
    1. Ensure that customers provide the payment status screenshot correctly to prevent reconciliation issues.

Don'ts:

  1. Do Not Close The Processing Screen When Payment In Progress
    1. Make sure the payment processing screen is active and remain open when the payment is in progress.
    2. Only close the processing screen when the payment is not valid.
  2. Do Not Force Complete When Payment Status Is Unconfirm
    1. Try not to force complete the payment when the payment status is unsure.