Qboon POS

Sell Gift Cards

Activate and sell Qboon gift cards at the POS. Card verification with number and PIN ensures only valid cards are sold.

Redeem as Payment

Customers can pay with Qboon gift cards. Real-time balance check ensures the card has sufficient funds.

Top-Up Cards

Recharge existing gift cards with custom amounts. The cashier sets the top-up amount after verifying the card.

Secure Verification

Every card operation requires card number + PIN verification against the Qboon API before processing.

Operation Logging

Full audit trail of every gift card operation with request/response data, timestamps, and status tracking.

Auto Setup

The Qboon Gift Card payment method is automatically added to all POS configurations on install. No manual setup needed.

Go to Settings and scroll down or search for "Qboon" in the left sidebar. You will see the Qboon Configuration section with three fields to fill in.

Fill in the following fields with the credentials provided by your Qboon account manager:

• Qboon Base URL — The API endpoint URL (default is pre-filled, change only if instructed)
• Qboon API Key — Your secret API key for authenticating requests
• Qboon Team ID — Your organization's team identifier on the Qboon platform

Click Save to apply the configuration.

On installation, a "Qboon Gift Card" payment method is automatically created and added to all your POS configurations. No manual setup is required. You can verify this by going to Point of Sale > Configuration > Payment Methods.

In the POS product screen, find and click the "Qboon Gift Card" product (SKU: QBOON-TC-01). A verification popup will appear automatically.

Enter the card number and PIN printed on the physical gift card, then click "Verify". The system will validate the card against the Qboon platform and retrieve the card's face value.

After successful verification, the gift card is added as an order line with its value as the price. The card number is shown on the line for reference. Complete the sale with any standard payment method (cash, card, etc.). The card is activated on the Qboon platform once the order is paid.

On the payment screen, click the "Qboon Gift Card" payment method button. The card verification popup will appear.

Enter the card number and PIN, then click "Verify". The system checks the card and displays the available balance. This is a two-step process — first verify, then enter the amount.

Enter the amount to redeem (up to the available balance) and click "Add Payment". A payment line is created with the specified amount. The remaining order total can be paid with another method if needed. The balance is deducted from the card once the order is validated.

Select the "Qboon Top Up Card" product (SKU: QBOON-TU-01) from the POS product screen. The verification popup appears where you enter the card number and PIN. After verification, the available balance is displayed and you can enter the top-up amount. The card is recharged on the Qboon platform once the order is paid.

Every gift card operation (sell, redeem, top-up) is logged in the Qboon Operation Log accessible from the backend. Each log entry includes the order reference, card number, operation type, amount, status (success/failed), HTTP status code, and full request/response data for debugging.

Internet Connection Required

All gift card operations require an active internet connection to communicate with the Qboon API. Offline POS mode is not supported for gift card transactions. Ensure your POS terminal has a stable connection.

Duplicate Protection

The plugin prevents the same card from being used twice in the same order — both for selling and redeeming. Each card operation is also protected by a server-side processed flag to avoid duplicate API calls.

Close POS Sessions Before Installing

The module automatically adds the Qboon payment method to all POS configurations during installation. Please close all open POS sessions before installing to avoid configuration conflicts.

Qboon Account Required

You need an active Qboon partner account with API credentials. Contact qboon.net to set up your organization and obtain your API key and Team ID.

Qboon for Digital Solutions

www.qboon.net