RoPay for WHMCS
The RoPay (Libra Internet Bank) payment gateway for WHMCS. Romanian customers pay an invoice by scanning a QR code in their banking app, RoPay confirms the payment server-to-server, and WHMCS marks the invoice paid automatically. Full and partial refunds, a tabbed admin console and a one-click Test/Production switch included.
What it does
A complete RoPay integration, not just a redirect. Everything a store needs to accept and reconcile RON payments through Libra Internet Bank.
QR / e-com checkout
The customer clicks Pay with RoPay and gets a QR code plus a banking-app deep link. No card data touches your server. The amount is always recomputed server-side from the invoice.
Server-to-server confirmation
Libra’s PUSH service calls a bearer-authenticated callback to mark the invoice paid, with a server-side status re-check as defense in depth, so a genuine payment is never lost or double-counted.
Full & partial refunds
Refund from the invoice or from the RoPay console, in full or in repeated partial amounts up to the remaining balance, reconciled with the refund push and recorded on the invoice.
Tabbed admin console
A dedicated admin page with Payments, Status and Setup tabs: every payment attempt with client, invoice, amount, QR id and status; a live configuration checklist; and a step-by-step setup guide.
Test / Production switch
Both credential sets and API URLs live side by side. A single toggle flips the whole gateway between the Libra test and production endpoints, with the active set clearly highlighted.
Security hardened
Owner-only payment endpoints (no IDOR), constant-time callback authentication, server-computed amounts, TLS verification on by default and https-only API endpoints. Built for a live billing system.
How a payment flows
Customer picks RoPay
On the invoice, the customer clicks Pay with RoPay and is shown a QR code and an open-in-app link. A fresh, single-use payment intention is created for every attempt.
They pay in their banking app
The customer scans the QR with any Romanian bank app that supports RoPay and confirms the RON payment. Nothing sensitive passes through your WHMCS.
Libra confirms server-to-server
RoPay’s PUSH service notifies your callback. The module verifies the bearer token, re-checks the status with RoPay, credits the invoice’s own balance and marks it Paid.
You reconcile in the console
The payment appears in the RoPay console with the client, invoice, amount and QR id. Refund in full or in part any time; the refund is reconciled and recorded on the invoice.
Compatibility & requirements
One package covers every PHP version that WHMCS 8.8+ and WHMCS 9 run on.
- WHMCS
8.8+and9.x· uses only stable gateway and callback APIs, unchanged between WHMCS 8 and 9- PHP
8.1,8.2and8.3· distributed ionCube-encoded for 8.1, runs on later 8.x- ionCube Loader
- Required · already present on every WHMCS server (WHMCS itself is ionCube-encoded)
- Bank / scheme
- Libra Internet Bank RoPay · RoPay API v1.1 · OAuth2 client-credentials · e-com QR / P2B
- Currency
RONonly, by design (Romanian bank accounts)- Refunds
- Full and repeated partial refunds · reconciled via the refund push
- License
- Annual, issued from our WHMCS · domain-locked with an offline grace period
- Delivery
- ionCube-encoded package · drop
modules/into your WHMCS root
or 50 RON / year · $12 / year
- ✓ Full gateway + admin console
- ✓ Free updates for the license term
- ✓ WHMCS 8 & 9, PHP 8.1 - 8.3
- ✓ Email support
Requires a Libra Internet Bank RoPay merchant account (Consumer Key/Secret + merchant uniqueId).