Alovio Payments · 8 pages
Getting started
What Alovio Payments is, what it needs, how to install and licence it, and how a payment is confirmed.
On this page
Alovio Payments adds the payment methods your customers actually use to Booknetic:
- Paystack — Nigeria, Ghana, Kenya, South Africa (NGN, GHS, KES, ZAR, USD);
- Xendit — Indonesia, the Philippines, Malaysia, Thailand, Vietnam, Singapore;
- Tap Payments — Kuwait, Saudi Arabia, the UAE, Bahrain, Oman, Qatar;
- Manual methods — your own bank transfer, cash or QR, in any currency.
With a gateway, the customer pays on the gateway’s own hosted page, so card details never touch your site, and a payment is marked paid only after the gateway itself confirms it. With a manual method, the customer gets your instructions and a payment code, and you mark the money as received. It runs on a regular Booknetic site and on Booknetic SaaS, where every business connects its own gateway account and writes its own methods — see Booknetic SaaS.
What it takes payment for
- Bookings made in the Booknetic booking panel — with every method.
- Booknetic payment links (online gateways). A link stays valid for 30 days. Each time the customer opens it, what is still owed is worked out again at that moment; an appointment that is already paid says so instead of opening a checkout.
- Package and gift card purchases made through Booknetic (online gateways).
At the confirm step the customer picks the gateway, and its checkout opens in a new window — or in the same tab when the browser blocks pop-ups.
Requirements
- Booknetic Pro 6.0.1 or newer, installed and activated — or Booknetic SaaS 4.0.0 or newer, which includes Pro. Booknetic loads add-ons only through an activated Pro: the free Booknetic plugin on its own does not load them. When that is the case, Alovio Payments says so in a notice in wp-admin. Any Booknetic plan works, Basic included: Alovio Payments brings its own gateways, so it doesn’t depend on which of Booknetic’s payment add-ons your plan includes.
- WordPress 6.4 or newer and PHP 8.1 or newer. On older PHP the plugin does not load; it shows a notice instead.
- For a gateway: an account with it — Paystack, Xendit or Tap Payments — and its API keys. Xendit also needs the site to run on HTTPS. Manual methods need nothing but your own details.
- A licence key, for new payments and updates (below).
Install
- In wp-admin go to Plugins → Add New → Upload Plugin, choose the zip, install and activate.
- Go to Alovio Payments → Settings and activate your licence key.
- Go to Alovio Payments → Gateways, open a gateway and enter its keys. On Booknetic SaaS each business enters its own keys in its Booknetic settings instead.
- In Booknetic → Settings → Payment methods, switch the gateway on.
- For bank transfer, cash or QR: Booknetic → Payments → Manual methods → Add method (a new method is switched on for you).
The gateway’s page in the hub lists these steps and ticks each one off by itself as it is done — the key saved, the connection checked, the first webhook received (Paystack and Xendit; Tap needs no webhook setup), the gateway offered in Booknetic.
The hub
Everything lives under one wp-admin menu, Alovio Payments:
-
Gateways — one line per gateway with its status and an on/off switch for the whole site (on Booknetic SaaS, for every business); open a line for the countries, currencies, methods and setup progress. Each gateway has its own page: setup steps, the connection form, the webhook URL, and the last 30 days of payments. Manual methods have a page of their own too.
Fig. 2The Gateways tab: one line per gateway Fig. 3A gateway opened: countries, currencies, methods and what to do next -
Transactions — every payment, with filters, search and a page per payment. See Transactions & refunds.
-
Integrations — the plugins Alovio Payments takes payments for: Booknetic, and whether it is installed on this site.
-
Settings — the licence, how long the gateways’ raw answers are kept, and whether to delete everything when the plugin is deleted.
Fig. 4Settings: licence, data and cleanup
The keys you enter are encrypted before they are stored and are never shown back — a saved key reads “Saved. Leave blank to keep it.” If the site’s WordPress security keys change, the stored keys can no longer be read and the form asks you to enter them again.
How a payment is confirmed
A payment is marked paid only after the gateway confirms the amount, the currency and the reference. Three things can confirm it, and whichever comes first is enough:
- The customer comes back from the checkout.
- The gateway’s webhook arrives — verified, so only the gateway can send it.
- Background checks keep asking the gateway — every few minutes at first, then less often — until the payment settles or its time runs out.
The booking is updated once, however many of the three arrive. If the gateway’s answer does not match, the payment is held under Needs a look instead of being marked paid.
A manual method has no gateway to ask: the payment waits until someone marks the money as received (or cancels it), and a method with a hold time releases the booking when that time runs out. See Manual methods.
How long a payment can stay open. A booking follows the payment time limit set in Booknetic; a package or gift card purchase gets 60 minutes. When that time runs out unpaid, the booking is released — even if the gateway cannot be reached. The checks go on for 24 hours afterwards, so a payment that lands late is still caught; if what it paid for is gone by then, it shows under Needs a look.
If the customer closes the payment window, nothing is decided on that alone. The gateway is asked first; if the payment is still being confirmed (bank transfers and mobile money can take a while), the customer is told so and asked not to pay again.
Background checks run on WordPress’s own scheduler (WP-Cron), which only runs when the site gets visits. On a quiet site, a real server cron keeps the checks on time.
Licence & updates
Open Alovio Payments → Settings, paste your licence key and click Activate. Activating uses one of the licence’s sites for this domain. The Licence card then shows the status, the sites in use, how long updates run, and when it was last checked, with Re-check, Check for updates and Release this site (which frees the site for another one).
- Without an active licence, new payments pause: the gateway is not offered at checkout. Payments already started are still confirmed and can still be refunded, and nothing is deleted. Activating a key brings the gateways back.
- When the update period ends, payments keep working as they are; only new versions stop.
- A licence server that can’t be reached changes nothing. Only a real answer from the server changes the status. The licence is re-checked once a day.
- Updates appear on the WordPress Plugins screen like any other plugin, and Check for updates is also on the Plugins screen next to the plugin. Updates are offered when the licence was confirmed within the last 14 days.
What the plugin sends, and how to switch the background requests off, is in the FAQ.
$29 · Product page
A salon on Booknetic SaaS taking rand — book with a bank transfer, then mark it received as the salon. It resets every hour.