E-Wallet and Credit Card Payment - Recheck Status & Force Complete
This guide walks you through what to do when a payment goes through on the terminal or e-wallet, but Classic POS fails to commit sales.
When Does This Happen?
During payment, Classic POS will show a "Connecting to Ewallet party..." or processing screen while waiting for a response from the payment gateway or terminal.
If the connection drops or times out, the screen will change to show a red ✕ icon with "Processing..." and two buttons — Recheck Status and Force Complete.
Common causes include:
- Unstable internet connection
- Connection timeout
- Loose or disconnected cable between POS and terminal
- Network interruption during payment processing
Step 1 — Try Recheck Status First
Click the green Recheck Status button.
This will attempt to query the payment status again from the payment gateway or terminal. Wait for the system to complete the check.
If successful, Classic POS will automatically commit sales and show a Payment Successful screen. Click Continue and you're done. ✅
If it still fails, proceed to Step 2.
Step 2 — Use Force Complete
⚠️ Only use Force Complete if you have physically verified that the customer's payment was successful on the terminal or e-wallet app.
2.1 Click the red Force Complete button.
2.2 A confirmation dialog will appear:
"Transaction currently in PROCESSING status. Are you sure to force complete?"
Click Yes to proceed.
2.3 You will be prompted to enter the Transaction Reference ID.
Key in the reference number from the terminal receipt or e-wallet confirmation, then click Ok.
2.4 A final confirmation dialog will appear:
"We will direct complete this sale. Please make sure the client payment is success."
Click Yes to confirm.
2.5 Classic POS will commit the sales and complete the transaction. ✅
Related Articles
NinePay Payment Integration
NinePay is part of the WavPay ecosystem, providing merchants with access to WavPay’s digital payment services. Through its integration with Xilnex Classic POS, NinePay enables merchants to accept a variety of cashless payment methods seamlessly at ...Xilnex-AutoCount - Posting Cash Sales
Cash Sales posting consolidates daily retail POS transactions and posts them to AutoCount Cash Book Entry, providing accurate cash-flow visibility and daily revenue tracking. What Is Cash Sales Posting? Cash Sales posting: Consolidates all retail ...Xilnex-AutoCount - Account Code Mapping
Account Code Mapping connects Xilnex transaction components (sales types, item categories, payment methods) to AutoCount GL accounts and payment codes. This ensures transactions post to the correct financial accounts. What Is Account Code Mapping? ...Xilnex-AutoCount - What Gets Synchronized?
The Xilnex–AutoCount integration establishes a seamless, automated data exchange between your Xilnex Retail Management System and AutoCount Accounting System, so your operational transactions are automatically reflected in your financial records. 1. ...Xilnex-AutoCount - Portal Configurations
All integration rules and configurations are managed through the Xilnex Web Portal. This guide walks you through accessing the portal and introduces the three core configuration areas. Accessing the Xilnex Web Portal: Open your web browser and ...
Recent Articles
Purchase Receiving vs Direct Receiving
Summary Both are GRN (Goods Receive Note) entry flows in Xilnex — used to record goods arriving at a site. Purchase Receiving is a PO-backed flow: goods arrive against a pre-existing Purchase Order, enabling 3-way matching (PO → GRN → Invoice). ...How to Install and Set Up Xilnex for Lark
Overview This article walks you through connecting your Lark workspace to your Xilnex account. This is a one-time setup step performed by an IT administrator, using the Configuration card in Xilnex Portal. Before You Begin Confirm you have the ...How to create Purchase Order
Overview This guide walks you through the process of creating a Purchase Order (PO) in the Xilnex Inventory module. A Purchase Order is used to formally record items you intend to purchase from a supplier, including quantities and unit costs. Once ...Transfer Note - User Manual Guide with multiple scenario
Description This guide covers everything related to the Transfer Note module in Xilnex Inventory — the feature used to move stock between HQ and outlets (or between outlets). It consolidates five workflows into one document: Create a Transfer Note ...How to Create Goods Receive Note
Description A Goods Receive Note (GRN) is used to record inventory received from a supplier into your outlet. After completing a Purchase Order (PO), you confirm and close it by creating the corresponding GRN — this moves the received items ...
Popular Articles
Basic - How to create a voucher-coupon
Voucher and coupon definition Voucher can be generated in bulk and can be used once Coupon can only be created one at a time (reusable code) and can be use multiple times Pre-voucher / coupon setup There are 2 things need to be prepared before we can ...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 ...Intermediate - How to Configure and Use Approval Settings in Purchase Orders (PO)
1.0 What is approval setting In general, "approval setting" refers to the configuration or process by which a request, action, or change must be reviewed and approved before it proceeds. The term is often used in business, software applications, and ...Buy 2 for Special Price Promotion
Use Case: Stock clearance, seasonal offers, or spotlight products. From the sample screenshot above, this promotion requires 2 items to trigger. If only 1 Milk Tea is added to the sales list, no discount will apply since the condition of 2 items is ...Creating Delivery Type for Sales in Classic POS
How to Create Delivery Type 1. Access to the [System Configuration] 2. Select the [Sales] section 3. In the [All Outlets] tab, look for the 'Delivery Type' 4. Click on the [Configure] In the Delivery Type Setup form: 1. Enter the Delivery Type. 2. ...