Ghid Complet: Integrarea Plăților maib în WordPress și Custom (Tehnic & Administrativ)

Dacă ai decis să colaborezi cu maib pentru procesarea plăților cu cardul (Visa/Mastercard/Apple Pay), trebuie să știi că procesul este mai complex decât un simplu „plug-and-play”. Acesta implică două etape critice: Birocrația (Contractarea) și Implementarea Tehnică (Certificatele de Securitate).

1. Etapa Administrativă: Semnarea Contractului

Nu poți începe integrarea tehnică fără a fi acceptat ca partener comercial de către bancă.

Pașii de urmat:

1. Cererea de E-commerce: Depui o solicitare la sucursala unde ai deschis contul juridic sau online prin managerul tău.
2. Verificarea Site-ului: Banca va face un audit al site-ului tău (chiar dacă e în stadiu de demo). Site-ul trebuie să conțină:
   • Datele de contact și IDNO-ul firmei în subsol.
   • Pagina „Termeni și Condiții”.
   • Politica de Confidențialitate (GDPR).
   • Politica de Livrare și Politica de Retur (foarte importante pentru bănci).
   • Logourile Visa și Mastercard vizibile.
3. Semnarea Contractului: Vei negocia comisionul (interchange fee) și vei semna acordul pentru „Acceptarea plăților prin carduri bancare în mediul virtual”.

2. Etapa Tehnică: Implementarea în WooCommerce

Spre deosebire de alți procesatori, maib utilizează un sistem bazat pe Certificate de Securitate (.pem) care trebuie instalate pe serverul tău.

A. Obținerea Credențialelor

După semnarea contractului, departamentul IT al băncii îți va trimite:

• Terminal ID și Merchant ID.
• O arhivă cu certificatele de test (cheia publică și cheia privată).
• Documentația API (E-commerce Gateway).

B. Instalarea pe WordPress (WooCommerce)

Deoarece WordPress nu are un modul maib nativ, vei avea nevoie de un plugin dedicat pentru Republica Moldova.

1. Primirea kit-ului: Odată ce contractul este semnat și dosarul tău este procesat, vei primi un email oficial de la echipa tehnică maib. Acest email conține atât instrucțiunile de configurare, cât și plugin-ul oficial maib (arhiva .zip) gata de instalare.

2. Instalarea propriu-zisă:

   • Descarcă arhiva atașată în email.

   • Mergi în panoul de administrare WordPress la secțiunea Module (Plugins) -> Adaugă modul nou -> Încarcă modul.

   • Selectează arhiva trimisă de bancă și apasă Instalează acum.

3. Configurarea și Endpoint-urile:

   • După activare, accesează setările modulului în WooCommerce.

   • Introdu datele de identificare furnizate în email (Terminal ID, Merchant ID).

   • Configurează Callback URL (URL-ul de primire a plăților). Acesta este esențial pentru ca serverul băncii să poată comunica automat cu site-ul tău și să marcheze comanda ca „Plătită” imediat ce tranzacția este finalizată.

3. Integrare Custom (Non-WordPress)

Dacă ai un site construit în Laravel, Python sau Node.js, va trebui să implementezi protocolul 3D Secure manual.

• Protocolul: maib folosește de obicei protocolul bazat pe semnătură digitală.
• Fluxul:
  1. Site-ul trimite o cerere către serverul maib cu suma și ID-ul tranzacției.
  2. Clientul este redirecționat către pagina securizată a băncii.
  3. După plată, serverul băncii trimite un semnal (POST request) către serverul tău.
  4. Verificarea Semnăturii: Serverul tău trebuie să valideze că răspunsul vine într-adevăr de la maib folosind cheia publică a băncii.

4. Nuanțe și „Capcane” Tehnice (Atenție!)

Din experiența noastră la Keywords.md, iată unde apar cele mai dese probleme:

• IP Static: maib solicită adesea ca serverul site-ului tău să aibă un IP static pentru a-l adăuga în lista lor de permisiuni (Allowlist). Dacă folosești un hosting ieftin cu IP partajat, plata s-ar putea să nu funcționeze.
• Versiunea PHP: Anumite module maib necesită versiuni specifice de PHP și extensia openssl activată.
• Perioada de Test (Sandbox): Nu poți trece direct la încasat bani. Trebuie să efectuezi cel puțin 2-3 tranzacții de test reușite (cu carduri speciale de test) pe care banca le va valida în sistemul lor.
• Trecerea în Producție: Odată validat, vei primi un nou set de certificate (Live) care le vor înlocui pe cele de test.

Tabel Recapitulativ: Checklist Integrare maib

Concluzie: Merită efortul?

Deși integrarea maib este mai tehnică decât cea a unui agregator, beneficiile sunt majore: cele mai mici comisioane de pe piață și o rată de încredere a clienților de 99%.

Nu vrei să-ți bați capul cu erorile de server și configurarea pluginului?

Integrarea maib este una dintre specialitățile noastre la Keywords.md. Ne ocupăm de tot procesul tehnic, de la comunicarea cu programatorii băncii până la testarea finală a tranzacțiilor pe site-ul tău.

Oferim:

• Instalare și configurare modul maib pentru WooCommerce.
• Asistență în pregătirea paginilor legale obligatorii.
• Configurare server pentru securitate maximă.
• Suport post-integrare.

👉 Solicită asistență tehnică pentru integrarea maib