Ce puteți face

• Oferiți opțiunea „Plată cu cardul (Netopia MobilPay)” în timpul finalizării comenzii în Odoo eCommerce.
• Permiteți clienților să plătească facturile restante direct din portalul de client Odoo.
• Urmăriți încercările de plată și starea finală a autorizării pentru comenzi/facturi în Odoo.
• Reduceți efortul de reconciliere manuală prin corelarea automată a tranzacțiilor reușite cu documentele corecte.

Cum funcționează (flux direct)

MobilPay utilizează un flux într-un singur pas în această integrare: cardul clientului este autorizat și suma este debitată imediat la finalizarea comenzii sau la plata unei facturi. Acest lucru este ideal pentru vânzările online unde doriți colectarea imediată a fondurilor.

Beneficii pentru afacere

• Rată de conversie mai mare pentru cumpărătorii locali prin utilizarea unui procesator de plăți românesc.
• Colectare mai rapidă a numerarului și mai puține comenzi neplătite datorită autorizării instantanee a cardului.
• Mai puțină muncă administrativă: plățile sunt înregistrate automat în raport cu documentul corect.
• Experiență mai bună pentru clienți printr-un flux de checkout simplu și securizat, gestionat de MobilPay.

Flux de lucru tipic

1. Un client plasează o comandă pe site-ul dvs. Odoo sau deschide o factură în portal.
2. Alege MobilPay ca metodă de plată și finalizează plata cu cardul (debitare imediată).
3. MobilPay confirmă rezultatul; Odoo actualizează comanda/factura aferentă în consecință.
4. Echipa dvs. continuă procesarea comenzii știind că plata este asigurată.

Fluxul de checkout și link-ul de plată (redirecționări)

• Atât de pe link-ul de plată din portalul de client (pagina de plată a facturii), cât și de la checkout-ul eCommerce, Odoo redirecționează clientul către pagina de plată securizată Netopia MobilPay, unde sunt introduse datele cardului și plata este înregistrată.
• După ce plata este finalizată sau anulată pe pagina băncii, clientul este redirecționat automat înapoi către site-ul dvs. Odoo reflectă apoi rezultatul pe documentul aferent (comandă sau factură).

Funcționalități

• Plată cu cardul securizată via Netopia MobilPay (flux prin redirecționare).
• Moduri Test și Live cu punctele lor terminale (endpoints) respective.
• Puncte terminale de confirmare și retur generate automat.
• Integrare cu site-ul web (website_sale) + pagină standard de stare a plății.
• Câmpuri de configurare pentru Semnătură POS, Cheie API și chei RSA (certificat public / cheie privată).
• Verificare opțională a stării la revenire, utilizând clientul REST Netopia ca alternativă în cazul în care IPN-ul nu a fost încă procesat.

Cerințe

• Pachete Python (instalate automat dacă folosiți cerințele agregate ale acestui depozit):
  • netopia-sdk
  • PyJWT
• Dependențe Odoo: payment, website_sale

Sfat: în acest depozit puteți instala pachetele suplimentare cu:

pip install -r odoo-addons/bitshop/requirements.txt

Notă importantă de instalare:

- Când instalați SDK-ul Netopia direct, utilizați următoarea comandă pentru a evita instalarea unor dependențe tranzitive incompatibile:
```
pip install --no-deps netopia-sdk
```
- Motivație: gestionăm dependențele prin Odoo și acest depozit; `netopia-sdk` poate declara cerințe largi care pot intra în conflict cu stiva Odoo. Instalarea cu `--no-deps` asigură compatibilitatea.

Configurare
-----------
1. Mergeți la Facturare/Contabilitate → Configurare → Procesatori de plăți → Creați sau Editați procesatorul "MobilPay".
- Stare: `Test` pentru sandbox, `Activat` pentru producție.
- Semnătură (POS signature).
- Cheie API (Netopia REST API key).
- Certificat Public (încărcați `.cer` sau PEM public furnizat de Netopia).
- Cheie Privată (încărcați cheia privată a comerciantului în format PEM).
- Website: setați site-ul pe care îl utilizați (URL-ul de bază va fi derivat din acesta).

2. Modulul calculează automat punctele terminale corecte:
- Sandbox: `https://sandboxsecure.mobilpay.ro/payment/card/index`
- Producție: `https://secure.mobilpay.ro/payment/card/index`

3. Pentru checkout-ul pe site, activați procesatorul și asigurați-vă că este disponibil pentru site-ul respectiv.

Fluxul de Checkout
------------------
- Clientul este redirecționat către pagina de plată securizată Netopia.
- Netopia apelează URL-ul de Confirmare (IPN) pentru a notifica Odoo despre schimbările de stare.
- Clientul este redirecționat înapoi la URL-ul de Retur, care în final redirecționează către pagina Odoo `/payment/status`.

Dacă revenirea are loc înainte de IPN, modulul încearcă o verificare a stării (GetStatus) via Netopia SDK și actualizează tranzacția Odoo.

Testare
-------
Carduri de test Netopia: [Suport Carduri de Test](https://suport.mobilpay.ro/index.php?/Comercial/Knowledgebase/Article/View/57/12/carduri-de-test)

Note și Sfaturi
---------------
- Utilizați mai întâi modul Test și verificați atât fluxul de Confirmare, cât și cel de Retur.
- Asigurați-vă că URL-ul de bază este corect (luați în considerare utilizarea HTTPS în scenarii reale).
- Păstrați cheile RSA în siguranță. Încărcați-le ca atașamente pe înregistrarea procesatorului; modulul le citește în mod securizat.

Table of contents

Authors

• Terrabit
• Dorin Hongu

Maintainers

Current maintainer:

This module is part of the terrabit-ro/bitshop project on GitHub.

You are welcome to contribute.