NinePay Payment Integration

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.
Idea
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.
IdeaPayment 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.