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 the point of sale.

Usage Eligibility

1. NinePay is only applicable for transactions involving eligible products and services under KPS (Keperluan Peralatan Sekolah).
   
2. Only items approved under the KPS guidelines can be purchased using NinePay through Xilnex Classic POS.
   
3. If a merchant attempts to use NinePay for non-eligible items, the payment may be rejected or authorization may fail.
   

How to Enable NinePay Payment in Xilnex Classic POS

STEP 1 : Add the Merchenant ID and Secret Key

Since NinePay is part of the WavPay ecosystem, both NinePay and WavPay use the same configuration area for credential setup.

1. Navigate to System Configuration.
   
2. Inside System Configuration, select the Payment section.
   
3. In the Current Outlet tab, go to WavPay Setting
   
4. Key in the Merchant ID and Secret Key
   
5. Save
   
   
   

STEP 2 : Add the E-Wallet Vendor as payment method

1. Navigate to System Configuration.
   
2. Inside System Configuration, select the Payment section.
   
3. In the All Outlet tab, go to E-Wallet Vendor Settings.
   
4. In the E-Wallet List, look for NinePay
   
5. Select NinePay → Add
   
6. Save the changes
   

How to Use NinePay During Checkout

Once NinePay has been enabled and configured, cashiers can begin accepting NinePay payments directly from Xilnex Classic POS.

Step-by-Step Process

1. Scan or select the items the customer wants to purchase.
   
2. Proceed to Payment
   
3. Select E-Wallet as payment type
   
4. From the list of available e-wallet providers, select NinePay.
   
5. An Authorization Number will prompt.
   
6. Scan Customer's QR provided by the customer using your POS scanner.
   
7. Once the QR is validated, NinePay will authorize the payment. The POS will update the status to PAID automatically.
   
   
   

Payment Response Behaviour

When processing payments using NinePay in Xilnex Classic POS, the system follows several validation rules enforced by WavPay/KPS. Below are the various responses you may encounter during a transaction.

Purchase Contains Non-Eligible Item

NinePay (under WavPay’s KPS program) only supports transactions for eligible items.

Behaviour:

1. If the cart contains any non-eligible item, The entire transaction will be blocked.
   
2. An error message will appear indicating that the purchase contains non-eligible items.
   

Example: If Eligible Item A + Non-eligible Item B are in the same bill → Payment will fail.

Eligible Item Added, But Requirements Not Fulfilled

Certain eligible items come with purchase rules enforced by Keperuluan Peralatan Sekolah (KPS).

For example:

1. Uniform Shirt
   
2. Uniform Pants
   

These items must meet specific quantity or pairing rules.

Behaviour:

1. If the merchant adds an eligible item but the required combination is not fulfilled, payment will not proceed.
   
2. No other items may be added until the rule is satisfied.
   

Payment Blocked: If customer does not fulfill the rule of purchasing rule (Uniform Shirt X Qty and Uniform Pants X Qty), and they try to purchase for other eligble items.

• Related Articles

• Enabling Foodpanda Integration

  The Foodpanda integration allows merchants to seamlessly receive and manage Foodpanda orders directly within the Xilnex POS system. By enabling this integration, Foodpanda sales orders are automatically synced into Xilnex, reducing manual entry, ...

• Enabling ShopeeFood Integration

  The ShopeeFood integration enables merchants to receive and manage ShopeeFood orders directly within the Xilnex POS system. Once enabled, ShopeeFood orders are automatically synced into Xilnex, reducing manual input, minimizing discrepancies, and ...

• Enabling GrabFood Self-Serve Integration

  The GrabFood integration enables merchants to seamlessly receive and manage GrabFood orders directly within the Xilnex POS system. Once enabled, GrabFood orders are automatically synced into Xilnex, reducing manual entry, minimizing errors, and ...

• 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 - 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

• Delivery Platform Packaging Fee Configuration

  Packaging Fee Packaging Fee is an additional charge imposed by the restaurant/merchant to cover takeaway and delivery packaging materials such as containers, cups, lids, bags, cutlery, seals, etc. For food delivery platforms: Foodpanda Foodpanda ...

• How to use replenishment module

  Introduction In Xilnex, the Replenishment Module is designed to streamline and automate the stock allocation process across outlets, ensuring optimal distribution and improved operational efficiency. Key capabilities include: Location Ranking for ...

• Staff Meal Integration

  Staff Meal Integration User Guideline Introduction Staff Meal Integration allows F&B POS to deduct staff meal credit / wallet balance directly from a third-party staff management system when staff purchase meals. This feature is currently supported ...

• Cancel Print of Full Tax Invoice

  Overview In Classic POS, there is a feature called Print Full Tax Invoice, which allows users to generate a full tax invoice for a completed sale. The system must maintain an auditable log whenever a Full Tax Invoice is cancelled. This guideline ...

• Xilnex API Guide for 3rd party

  1. Objective The objective of this API guide is to provide a clear reference for developers and integration partners on how to utilize the Xilnex APIs to establish communication with the Xilnex system. The guide outlines the available endpoints, ...

• 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 ...

• Basic - How to change custom cost to another branch that don’t have custom cost

  Change custom cost to another branch that don’t have custom cost 1. Get the item list from the location with custom cost (Item Code, Name, Custom Cost) 2. Make sure the Show Location Price are selected 3. Export the item list in Excel 4. The file ...

• Intermediate - How to Bill & Post to Sales from Transfer Note

  1.0 Purpose A bill is required from transfer note when an inventory transfer involves financial transactions, cost allocation, or compliance with tax and accounting regulations. It is used when stock is moved between outlets that operate as separate ...

• Basic - How to enable E-Receipt Portal and QR Code Setup on Printing format in Xilnex

  Enable E-Receipt Portal Enable the E-receipt functionality Once Enabled, you will be getting the E-Receipt portal link Continue under Theme & Styling, enabled for the E-Invoice (LHDN) You can customize the look and feel of the E-Receipt portal ...