netSEO Netopia pentru CS-Cart - Modul Plata cu Card (Integrare Netopia/Mobilpay)

netSEO: Netopia / MobilPay pentru CS-Cart

netSEO: MobilPay Netopia este un addon profesional pentru CS-Cart care integrează plata cu cardul (credit/debit) prin serviciul Netopia. Modulul permite clienților să plătească în siguranță pe portalul mobilpay.ro, iar comenzile sunt actualizate automat la confirmarea sau anularea plății, cu mapare completă a statusurilor și suport pentru mediul Live și Sandbox.

Plată cu card prin Netopia

Modulul oferă integrarea nativă cu MobilPay (mobilpay.ro):

• Redirect client către pagina securizată MobilPay pentru introducerea datelor card
• Suport carduri de credit și debit
• Comunicare criptată (chei publice/private) conform specificațiilor Netopia
• Return URL și callback (notificare server-to-server) pentru sincronizare comandă

Mediu Live și Sandbox

Administratorii pot lucra în două medii:

• Live – pentru plăți reale (certificat și cheie privată Live)
• Sandbox – pentru testare (certificat și cheie privată Sandbox)

Modul Test din setările metodei de plată folosește cheile Sandbox; modul Live folosește cheile Live. Sistemul detectează automat cheia corespunzătoare la confirmarea notificărilor de la Netopia.

Încărcare și gestionare chei Netopia

Cheile primite de la Netopia se configurează direct din setările addon-ului:

• Încărcare certificat public Live (.cer) și cheie privată Live (.key)
• Încărcare certificat public Sandbox (.cer) și cheie privată Sandbox (.key)
• Salvare automată în app/payments/mobilpay_files/data/ cu nume standard (live.public.cer, live.private.key, sandbox.public.cer, sandbox.private.key)
• Validare extensii fișiere și mesaje clare în cazul erorilor (director neaccesibil, salvare eșuată)

Mapare statusuri comenzi

Fiecare eveniment MobilPay este mapat la un status de comandă din platformă:

• Confirmare plată (MobilPay: confirmed) – status ales pentru plată confirmată (ex: Comandă procesată)
• Anulare (MobilPay: canceled) – status pentru plată anulată
• Ramburs (MobilPay: credit) – status pentru returnarea sumei către client
• În așteptare (MobilPay: paid / paid_pending / confirmed_pending) – status pentru plăți în curs de verificare (se recomandă să nu se livreze până la confirmare)
• Eroare notificare – status pentru erori la primirea confirmării de la MobilPay

Toate statusurile se aleg din lista de statusuri de comandă CS-Cart (Administrare → Statusuri → Comenzi), asigurând consistența cu restul workflow-ului.

Procesare notificări și actualizare comandă

Modulul procesează corect notificările (callback) de la MobilPay:

• Descriptare date primite cu cheia privată (încercare sandbox, apoi live)
• Identificare acțiune: confirmed, confirmed_pending, paid_pending, paid, canceled, credit
• Actualizare status comandă conform mapării configurate
• Răspuns XML conform specificațiilor MobilPay (crc) pentru confirmarea primirii
• Protecție împotriva datelor invalide sau a lipsei fișierelor de chei

Informații plată pe comandă

Platforma păstrează legătura cu tranzacția MobilPay:

• Coloană dedicată în tabelul comenzilor pentru date MobilPay (ex. referință tranzacție)
• Posibilitate de urmărire și debugging al plăților asociate comenzii

Cerințe la checkout

Pentru a respecta cerințele MobilPay/Netopia, modulul asigură prezența datelor obligatorii:

• Email și telefon setate ca obligatorii la checkout și în profil (la instalare)
• Datele sunt trimise în request-ul către MobilPay conform specificațiilor

Compatibilitate și securitate

Addon-ul este construit pentru stabilitate și conformitate:

• Compatibil CS-Cart 4.10.1+, ediții ULTIMATE și MULTIVENDOR
• Fișierele de chei sunt stocate în director dedicat, cu control acces și extensii validate
• La dezinstalare se elimină procesorul de plată și coloana MobilPay din comenzi; licența este ștearsă din Addons Manager

Integrare nativă în CS-Cart

netSEO: MobilPay Netopia se integrează în Administrare ca metodă de plată (Procesare → Metode de plată) și la checkout ca opțiune de plată cu card. Configurarea cheilor și a statusurilor se face din Setări addon, iar fluxul de plată (redirect → MobilPay → return și callback) este gestionat integral de modul.

Fără o integrare dedicată MobilPay/Netopia, acceptarea plăților cu cardul în România necesită soluții manuale sau adaptări generice. Acest addon oferă o soluție completă, cu chei Live/Sandbox, mapare clară a statusurilor și procesare corectă a notificărilor, potrivită pentru magazine CS-Cart care folosesc MobilPay (Netopia) ca metodă de plată principală sau suplimentară.