Dacă vinzi domenii .RO din WHMCS sau din propria platformă, nu vrei să le înregistrezi de mână. Ai nevoie de un API pentru domenii .RO sau de un modul WHMCS care să facă singur înregistrarea, reînnoirea și sincronizarea cu ROTLD. În acest articol vezi cum funcționează fluxul complet, ce operațiuni poți automatiza și cum folosești rezervarea ROTLD ca să nu plătești domenii pe care clientul nu le achită.
Cum circulă o comandă de domeniu .RO
- Clientul comandă domeniul pe site-ul tău sau în WHMCS-ul tău.
- Modulul WHMCS (sau aplicația ta) trimite o cerere semnată către API-ul registrarului.
- Registrarul verifică datele titularului și trimite operațiunea la ROTLD.
- ROTLD înregistrează domeniul, iar data de expirare ajunge înapoi în WHMCS la sincronizare.
Ce poți automatiza
| Operațiune | În WHMCS | Prin API |
|---|---|---|
| Verificare disponibilitate | Lookup Provider | domain.check |
| Înregistrare | automat la plată | domain.register |
| Rezervare 30 de zile + activare | la comandă / la plată | domain.reserve, domain.activate |
| Reînnoire | automat la plată | domain.renew |
| Transfer de la alt registrar | da | domain.transfer |
| Nameservere și nameservere proprii | da | domain.nameservers.set, ns.register |
| Cod EPP (authcode) | da | domain.eppcode |
| Sincronizare expirare | cron WHMCS | domain.info |
| Import prețuri | Registrar TLD Sync | pricing.tlds |
Modulul WHMCS: instalare în 5 minute
- Urci folderul
modules/registrars/storewebîn WHMCS. Modulul merge pe WHMCS 7.10, 8.x și 9.x, cu PHP 7.2 – 8.4. - Îl activezi din Domain Registrars și introduci ID-ul cheii API și secretul, pe care le generezi din contul STOREWEB.
- La Domain Pricing setezi
.rocu Auto Registration = STOREWEB. - Imporți prețurile din Utilities › Registrar TLD Sync și alegi marja.
- Opțional, bifezi „Rezervă .RO la comandă”.
Rezervarea ROTLD: înregistrezi doar ce s-a plătit
Cea mai mare pierdere a unui reseller e domeniul înregistrat pentru un client care nu mai plătește factura. ROTLD rezolvă asta prin rezervare:
- Domeniul se rezervă în momentul comenzii și rămâne blocat 30 de zile.
- Taxarea se face abia la activare, adică atunci când clientul plătește și WHMCS trimite înregistrarea.
- Dacă nu se plătește în 30 de zile, rezervarea expiră fără cost, iar domeniul redevine liber.
- Un domeniu rezervat nu poate fi modificat (de exemplu nameserverele) până la activare, iar același domeniu se poate rezerva o singură dată la 180 de zile.
Domenii .RO expirate: cum se eliberează și cum le prinzi
Un domeniu .RO neplătit la expirare intră în starea pendingDelete. Conform anunțului ROTLD privind mentenanța anuală, domeniul este șters la aproximativ 90 de zile după expirare. De exemplu, un domeniu expirat pe 1 iunie devine liber pe 30 august. Titularul îl poate reînnoi în acest interval. După ștergere, domeniul se înregistrează pe principiul „primul venit, primul servit”.
Ora exactă a ștergerii nu este garantată. De aceea, o încercare unică la miezul nopții ratează des domeniul. Abordarea corectă are trei părți:
- citești data de expirare din WHOIS-ul ROTLD, nu data înregistrării, pentru că domeniul poate fi plătit pe mai mulți ani sau poate avea data resetată după un trade;
- în jurul zilei estimate verifici disponibilitatea des, prin serviciul DAS al ROTLD;
- în momentul în care domeniul apare liber, îl rezervi cu un singur apel, cu datele titularului pregătite din timp.
STOREWEB face această captură pentru domeniile cerute de clienți. Dacă te interesează un domeniu .RO care urmează să expire, scrie-ne și îl punem în urmărire.
Securitatea integrării
- Fiecare cerere API este semnată (HMAC-SHA256), are o fereastră de timp de 5 minute și nu poate fi retrimisă.
- Poți permite accesul doar de pe IP-urile serverului tău.
- Secretul cheii se afișează o singură dată. Dacă îl pierzi, generezi o cheie nouă.
- Un reseller vede și modifică doar domeniile din contul lui.
Erori frecvente la înregistrarea domeniilor .RO
| Mesaj | Cauză | Soluție |
|---|---|---|
| Date titular incomplete | lipsește județul, telefonul sau adresa | completează profilul clientului; telefonul în format +40.722000000 |
| CNP / CUI lipsă | titular din România fără cod de identificare | CNP pentru persoane fizice, CUI pentru firme |
| Nr. Reg. Com. lipsă | titular firmă (societate comercială) | completează numărul de la Registrul Comerțului |
| INVALID DOMAIN PASSWORD | parola de domeniu nu respectă regulile ROTLD | majusculă, minusculă, cifră și caracter special; modulul o generează corect |
| Expirare peste 10 ani | reînnoire prea lungă | reînnoiește pe mai puțini ani |
Întrebări frecvente
Modulul merge pe WHMCS 7.10?
Da, merge pe WHMCS 7.10, 8.x și 9.x. Importul prețurilor (Registrar TLD Sync) e disponibil de la WHMCS 7.10 în sus.
Pot folosi API-ul fără WHMCS?
Da. API-ul primește cereri JSON semnate, iar documentația o descarci din contul STOREWEB, de la Reseller Domenii .RO.
Se plătește abonament pentru API?
La pachetele Silver și Gold, nu: API-ul și modulul WHMCS sunt incluse. La Start, accesul API costă 5 € pe lună.