RoPay for WHMCS
WHMCS 8 si 9 Activ · v1.2.3 PHP 8.1 – 8.5 RON · Libra Internet Bank Protejat ionCube

RoPay pentru WHMCS

Gateway-ul de plata RoPay de la Libra Internet Bank pentru WHMCS. Clientii din Romania platesc o factura scanand un cod QR in aplicatia bancii; RoPay confirma plata server-to-server, iar WHMCS marcheaza factura ca platita automat. Include rambursari totale si partiale, o consola admin cu tab-uri si un comutator Test/Production dintr-un click.

Capturi de ecran

Vezi modulul in actiune

Capturi din versiunea 1.2.2 cu date de exemplu: pagina de plata, consola de plati cu rambursari dintr-un click, lista de rambursari, ghidul de configurare si pagina de actualizari.

Apasa pentru marire
dreamserver.ro/client/…/modules/gateways/ropay/createintention.php
Pagina de plata - gandita pentru telefon: deschizi aplicatia bancii dintr-o atingere sau scanezi codul QR, cu timpul de valabilitate
Pagina de plata – gandita pentru telefon: deschizi aplicatia bancii dintr-o atingere sau scanezi codul QR, cu timpul de valabilitate
dreamserver.ro/client/…/addonmodules.php?module=ropaylog
Consola de plăți - lista „Necesită atenție”, carduri de sumar, filtre, export CSV și rambursări cu limită pe plată
Consola de plăți - lista „Necesită atenție”, carduri de sumar, filtre, export CSV și rambursări cu limită pe plată
dreamserver.ro/client/…/addonmodules.php?module=ropaylog › Rambursări
Rambursări - fiecare rambursare trimisă la bancă și rezultatul ei, cu filtre și export CSV
Rambursări - fiecare rambursare trimisă la bancă și rezultatul ei, cu filtre și export CSV
dreamserver.ro/client/…/addonmodules.php?module=ropaylog › Ghid de instalare
Ghid de instalare - configurarea inițială pas cu pas și drumul unei plăți
Ghid de instalare - configurarea inițială pas cu pas și drumul unei plăți
dreamserver.ro/client/…/addonmodules.php?module=ropaylog › Actualizări
Actualizări - update cu un click, pachete semnate și verificarea instalării
Actualizări - update cu un click, pachete semnate și verificarea instalării

Consola admin live & configurarea gateway-ului · consola stocheaza fiecare intentie si rambursare si leaga tot request/response-ul in Utilities > Logs > Gateway Log

Fluxul platii

De la factura la platit, fara card

Un flux cu redirect + push asincron. Niciun fel de date de card nu ajung in WHMCS-ul tau, iar suma incasata e mereu recalculata server-side din factura.

1
Clientul alege RoPay
Pe factura apasa Plateste cu RoPay si primesc un cod QR nou, de unica folosinta, plus un link de deschidere in aplicatie.
Instant
2
Plateste din aplicatia bancii
Clientul scaneaza codul QR cu orice aplicatie de banca din Romania care suporta RoPay si confirma plata in RON.
La client
3
Libra confirma server-to-server
Serviciul PUSH al RoPay apeleaza callback-ul tau autentificat cu bearer token; modulul reverifica statusul si crediteaza factura.
Automat
Ce poate

Ce contine

O integrare RoPay completa, nu doar un redirect. Tot ce ii trebuie unui magazin ca sa accepte, sa confirme si sa reconcilieze plati in RON prin Libra Internet Bank.

Checkout QR / e-com

Clientul primeste un cod QR plus un deep link catre aplicatia bancii. Niciun fel de date de card nu ajung pe serverul tau. Fiecare click genereaza o intentie noua, de unica folosinta, ca un QR expirat sa nu fie reafisat niciodata.

Confirmare server-to-server

Serviciul PUSH al Libra apeleaza un callback autentificat cu bearer token ca sa marcheze factura platita, cu o reverificare de status server-side ca aparare in profunzime, deci o plata reala nu se pierde si nu e numarata de doua ori.

Status live pe pagina de plata

Pagina de plata isi interogheaza propriul endpoint si reactioneaza in timp real: trece un QR scanat (acum consumat) in starea “in procesare” si ofera un QR nou dupa o expirare sau un refuz.

Doar RON, facut corect

Facturile care nu sunt in RON primesc un mesaj profesional bilingv care invita clientul sa ceara reemiterea in RON, in loc de o eroare seaca. Suma si moneda sunt recalculate din baza de date, niciodata din formular.

Securitate intarita

Endpoint-uri de plata accesibile doar proprietarului (fara IDOR), autentificare de callback in timp constant, sume calculate server-side, verificare TLS activa implicit si endpoint-uri API doar pe https. Construit pentru un sistem de facturare real.

Comutator Test / Production

Ambele seturi de credentiale si API URL-uri stau unul langa altul. Un singur comutator schimba gateway-ul intre endpoint-urile Libra de test si productie, cu setul activ evidentiat clar.

Rambursari totale & partiale repetate

Rambursezi suma intreaga sau emiti rambursari partiale repetate pana la soldul ramas, din factura sau din consola RoPay. Suma ramasa rambursabila e impusa server-side.

Reconciliere asincrona

Un apel de rambursare doar “initiaza”; push-ul de rambursare aduce rezultatul final. Rambursarile confirmate sunt logate, iar o rambursare esuata e semnalata clar ca sa poti anula tranzactia WHMCS corespunzatoare.

Inregistrate pe factura

Fiecare rambursare apare pe factura ca o tranzactie standard WHMCS de iesire (fara factura de rambursare separata) si intr-un tabel Refunds in consola, cu etichete Partial / Full si un badge de status.

Tab-uri Payments / Status / Setup

O consola admin cu tab-uri: fiecare incercare de plata cu client, factura, suma, id QR si status; un checklist de configurare live cu badge Production / Test; si un ghid de setup pas cu pas.

Generator de token callback

Generezi bearer token-ul de callback push dintr-un click, chiar langa camp pe pagina de setari a gateway-ului (sau dintr-un helper CLI inclus), apoi il dai Librei impreuna cu URL-ul de callback.

Endpoint-uri editabile

Consumer Key / Secret, merchant uniqueId si API URL sunt configurabile per mediu. Logarea detaliata a gateway-ului poate fi pornita pentru debug si oprita in productie.

Actualizări cu un click

Configurare › Actualizări verifică la cerere dacă există o versiune nouă, arată fiecare fișier modificat și o instalează. Pachetele sunt semnate digital, înainte se face un backup, iar versiunea anterioară revine automat dacă apare o problemă. Verificarea instalării compară fiecare fișier cu versiunea semnată.

WHMCS
8.8+ si 9.x · foloseste doar API-uri stabile de gateway si callback, neschimbate intre WHMCS 8 si 9
PHP
8.1 – 8.5 · doua pachete ionCube, alese dupa Loader: loader15 (Loader 15+, PHP 8.1 – 8.4, 8.5 cu Loader 15.5+) si loader14 (Loader 14, PHP 8.1 – 8.3)
Banca / schema
Libra Internet Bank RoPay · RoPay API v1.1 · OAuth2 client-credentials · e-com QR / P2B
Moneda
doar RON, prin design (conturi bancare din Romania)
Rambursari
Rambursari totale si partiale repetate · reconciliate prin push-ul de rambursare
Tabele baza de date
mod_ropay_intentions, mod_ropay_refunds · create si migrate automat
Licenta
Anuala, emisa din WHMCS-ul nostru · o instalare activa per licenta, cu o perioada de gratie offline
Instalare

De la upload la live in patru pasi

Pui modulul in radacina WHMCS, configurezi gateway-ul si iti inregistrezi callback-ul la Libra. Tab-ul Setup din consola RoPay te ghideaza cu un checklist live.

1
Incarca fisierele
Copiezi modules/ in radacina WHMCS. Necesita ionCube Loader (deja prezent pe orice server WHMCS).
Gata
2
Activeaza & configureaza
Activezi RoPay in Setup > Payments, lipesti Consumer Key / Secret Libra + merchant uniqueId, tii Environment pe Test.
Gata
3
Genereaza tokenul de callback
Apesi Generate langa campul de push bearer token, salvezi si inregistrezi URL-ul de callback + tokenul la Libra.
Gata
4
Testeaza, apoi live
Platesti o factura de test prin QR, confirmi ca ajunge PAID, apoi comuti Environment pe Production.
Live
Note de lansare

Changelog

In ordine invers cronologica, cate o intrare pe luna (versiunea afisata este ultima lansata in luna respectiva). Modulul ruleaza in propriul nostru WHMCS de facturare pe API-ul RoPay Libra live inainte de fiecare lansare.

v1.2.3 Noiembrie 2026 Ultima

  • Nou Două pachete, alese după ionCube Loader: loader15 (Loader 15 sau mai nou, PHP 8.1 – 8.4, PHP 8.5 cu Loader 15.5+) și loader14 (Loader 14, PHP 8.1 – 8.3). O actualizare de PHP în acest interval nu mai cere alt pachet, iar serverele cu ionCube Loader 14 sunt suportate.
  • Nou Actualizare cu un click: Configurare > Actualizări verifică la cerere dacă există o versiune nouă, arată fiecare fișier modificat și o instalează. Pachetele sunt semnate digital și verificate înainte, se face un backup, iar versiunea anterioară revine automat dacă apare o problemă.
  • Nou Verificarea instalării: compară fiecare fișier al modulului cu versiunea semnată și arată ce a fost modificat, ce lipsește și ce nu îi aparține. Backup-uri cu restaurare și descărcare, se păstrează ultimele 3.
  • Nou Consolă de administrare redesenată: antet cu versiunea și mediul, meniul Configurare (Stare, Ghid de instalare, Actualizări), carduri de sumar colorate, tabele și ferestre mai clare și meniu adaptat pentru telefon.
  • Nou Pagina de plata redesenata, gandita intai pentru telefon: o atingere deschide aplicatia bancii, pe desktop codul QR e primul. Afiseaza numele firmei tale, suma in formatul clientului, cat mai e valabil codul si un mesaj clar pentru fiecare stare (in procesare, platit, expirat, anulat, banca indisponibila temporar).
  • Nou Platile sunt confirmate chiar daca o notificare de la banca se pierde: modulul reverifica automat platile deschise si din consola, iar aceeasi plata nu este inregistrata niciodata de doua ori.
  • Nou Consola de administrare refacuta: lista Necesita atentie, filtre dupa stare, data si mediu, carduri de sumar cu sume, export CSV, fereastra de restituire cu limita pe plata, reverificare la banca si verificare de functionare la cerere.
  • Îmbunătățire Restituiri mai sigure: un raspuns neclar de la banca este afisat ca atare si o restituire nu este trimisa niciodata de doua ori; restituirile sunt inregistrate in WHMCS.
  • Îmbunătățire Romana si engleza pentru pagina de plata si consola de administrare.
  • Îmbunătățire Intarire de securitate si fiabilitate in gateway, pagina de plata si consola de administrare. Actualizarea este recomandata pentru toate instalarile.
  • Securitate Verificarea licenței a fost consolidată: o eroare temporară de rețea în timpul verificării licenței nu mai dezactivează o licență validă. Actualizarea este recomandată.

v1.1.14 Octombrie 2026

  • Nou Consola RoPay afiseaza versiunea instalata langa titlu si, cand apare o versiune noua, un badge evidentiat „Actualizare disponibila” si un banner cu link catre zona de client. Notificarea apare si pe pagina de setari a gateway-ului. Verificare de maxim doua ori pe zi; platile si licentierea nu sunt afectate.
  • Îmbunătățire Instructiuni de actualizare mai clare in INSTALL.md si README: actualizarea inseamna doar urcarea fisierelor noi peste cele vechi; fara dezactivare, fara pasi in baza de date, cheia de licenta ramane valabila.

v1.1.12 August 2026

  • Nou RoPay apare acum cu logo, slogan si lista de functii in browserul WHMCS “Apps & Integrations › Browse › Payments”, langa ceilalti furnizori.
  • Nou Comutator Test / Production pe pagina de setari a gateway-ului (inlocuieste dropdown-ul), cu un accent colorat pe setul de credentiale activ.
  • Nou Campuri editabile “API URL (Test)” / “API URL (Production)”, cu valorile implicite pe endpoint-urile Libra.
  • Nou Buton Generate dintr-un click pentru push callback bearer token, plus un helper CLI inclus.
  • Îmbunătățire Setup mai clar inainte de activare: pagina de configurare afiseaza doar campul License Key pana cand exista o licenta valida, apoi arata toate setarile.
  • Îmbunătățire Livrat acum ca un build per versiune de PHP (8.1, 8.2, 8.3, 8.4); build-ul de 8.4 ruleaza si pe PHP 8.5. Imbunatatiri de fiabilitate si performanta peste tot.
  • Îmbunătățire Consola admin reproiectata in tab-uri Payments / Status / Setup: badge de mediu, checklist de configurare, URL de callback si un ghid de setup la prima utilizare.
  • Fix Rezolvata o eroare care putea aparea la activarea gateway-ului.
  • Întărire API URL-ul editabil e doar https, deci credentialele consumer nu pot iesi niciodata in clar.

v1.0.0 Iulie 2026

  • Nou Prima lansare: gateway RoPay cu OAuth2 client-credentials, intentie de plata e-com QR, polling de status si un callback PUSH autentificat cu bearer token.
  • Nou Rambursari totale si partiale repetate, reconciliate cu push-ul de rambursare si inregistrate pe factura.
  • Nou Privire de ansamblu admin peste fiecare incercare de plata si rambursare, cu cautare si paginare.
  • Îmbunătățire State machine live pe pagina de plata: CREATED → IN_PROGRESS → PAID, cu reincercare la expirare sau refuz.
Cerinte

Va rula pe instalarea ta?

Un gateway de plata WHMCS obisnuit plus un mic addon de admin. Il pui in modules/gateways/ si modules/addons/, il activezi din admin si gata. Fara servicii externe, fara coada de mesaje, fara baza de date separata.

WHMCS
WHMCS 8.8+ si 9.x · foloseste doar API-uri stabile de gateway / callback
PHP
8.1 – 8.5 · doua pachete, alese dupa ionCube Loader: loader15 (Loader 15+) sau loader14 (Loader 14, PHP 8.1 – 8.3) · Loader-ul este deja prezent pe orice server WHMCS
Cont Libra
Un contract semnat cu Libra Internet Bank (LibraBank) si serviciul RoPay activat pe contul tau de merchant · Consumer Key / Secret + merchant uniqueId din devportal-ul Libra
HTTPS iesire
Serverul tau trebuie sa ajunga la API-ul RoPay prin HTTPS (*.librabank.ro:8243). Intai test, apoi productie
Moneda
RON · doar conturi bancare din Romania
Baza de date
MySQL / MariaDB prin WHMCS · modulul isi creeaza si migreaza singur tabelele
Dupa comanda

Descarcari, actualizari & cheia de licenta – in contul tau

Cumperi licenta o data si totul sta in contul tau DreamServer. Deschizi serviciul RoPay si un panou Downloads & Documentation iti da fiecare versiune lansata, changelog-ul, ghidul de instalare si cheia ta de licenta – cat timp licenta ramane activa. Versiunile noi apar acolo automat; fara emailuri de urmarit.

dreamserver.ro/client/clientarea.php?action=productdetails&id=…
RoPay pentru WHMCS Licenta activa
Descarcari & Documentatie
Descarca ultima (v1.2.3)

Gateway de plata RoPay Libra Internet BankWHMCS 8.8+ si 9 · PHP 8.1 – 8.5 · ionCube Loader 14 sau 15

Cheia ta de licenta
ROPAY-7QF2K-9M4XA-BZ13R-8HD6PCopiaza
Ultima versiune
v1.2.3 Ultima
Lansat 2026-11-18 · loader15 · loader14 (alegi dupa ionCube Loader-ul serverului)
▸ Ce contine aceasta versiune
Descarca zip

Accesul la descarcari ramane disponibil cat timp licenta e activa. Ai nevoie de ajutor? Deschide un tichet din contul tau.

Mereu versiunea curenta

Descarci build-ul curent pentru ionCube Loader-ul serverului tau, direct din pagina serviciului; din 1.2.2 actualizezi si direct din consola RoPay. Securizat, per cont, niciodata un link public.

Actualizari gratuite cat e activa

Fiecare versiune noua e inclusa pe toata durata licentei. Apare in contul tau in momentul in care o publicam – cu changelog-ul ei.

Acces legat de licenta

Descarcarile sunt legate de licenta ta activa. Reinnoiesti si pastrezi acces complet; aceeasi cheie activeaza modulul in WHMCS.

Afisat pe serviciul tau la clientarea.php?action=productdetails · descarcarile sunt conditionate de o licenta activa si servite per cont

Pret

O licenta anuala

Licenta anuala
€10 / an

sau 50 RON / an · $12 / an

  • ✓ Gateway complet + consola admin
  • ✓ Rambursari totale & partiale
  • ✓ Actualizari gratuite pe durata licentei
  • ✓ WHMCS 8 & 9, PHP 8.1 – 8.5
  • ✓ Suport pe email
Comanda RoPay pentru WHMCS

Necesita un contract LibraBank. RoPay functioneaza prin Libra Internet Bank - ai nevoie de un contract semnat cu LibraBank si de serviciul RoPay activat pe contul tau de merchant.

Avem Incredere & Suntem Membri

Suntem membri ai principalelor organizatii de infrastructura internet.

RIPE NCC MANRS PeeringDB RoTLD DSIX SBIX 4IXP LOCIX Euro-IX RIPE NCC MANRS PeeringDB RoTLD DSIX SBIX 4IXP LOCIX Euro-IX