netSEO EuPlatesc pentru CS-Cart - Modul Integrare Plata Online (Card, Google Pay, Apple Pay)

netSEO: EuPlatesc pentru CS-Cart

netSEO: EuPlatesc este un addon profesional pentru CS-Cart care integrează plata online prin serviciul EuPlatesc.ro. Modulul permite clienților să plătească în siguranță cu cardul (credit/debit) pe portalul securizat EuPlatesc, cu suport pentru Google Pay și Apple Pay acolo unde sunt oferite de EuPlatesc. Comenzile sunt actualizate automat la confirmarea sau eșecul plății, cu mapare configurable a statusurilor.

Plată online prin EuPlatesc.ro

Modulul oferă integrarea nativă cu EuPlatesc (secure.euplatesc.ro):

• Redirect client către pagina securizată EuPlatesc pentru introducerea datelor de plată (card, Google Pay, Apple Pay)
• Comunicare securizată: semnătură MAC HMAC-MD5 (fp_hash) conform documentației API EuPlatesc
• Transmitere automată a sumei, monedei (RON/EUR), descrierii comenzii și identificatorului facturii (order_id)
• Return URL (successurl / failedurl) și callback server-to-server (silenturl) pentru sincronizare comandă

Procesul de plată este rapid și conform specificațiilor EuPlatesc (tdsprocess).

Configurare metodă de plată

În setările metodei de plată CS-Cart (Administrare → Plăți) se configurează:

• Merchant ID (MID) – identificatorul contului EuPlatesc (account_number)
• Cheie secretă (KEY) – cheia în format hex (32 caractere) primită de la EuPlatesc, folosită pentru calculul MAC
• Monedă – RON sau EUR, în funcție de contul EuPlatesc și de moneda magazinului

În panoul EuPlatesc trebuie configurat URL-ul de callback: site/index.php?dispatch=payment_notification.notify&payment=euplatesc. Modulul generează automat URL-urile de success și fail cu sesiunea în parametri, astfel încât la revenirea din EuPlatesc clientul rămâne autentificat.

Mapare statusuri comenzi

Fiecare eveniment EuPlatesc este mapat la un status de comandă din platformă (setări addon – secțiunea „Mapare statusuri comenzi”):

• Status la plată aprobată (action=0) – statusul comenzii când EuPlatesc confirmă tranzacția cu succes (implicit: Comandă procesată)
• Status la plată eșuată / refuzată – statusul comenzii când plata este refuzată, anulată sau eșuează (implicit: Comandă eșuată)

Statusurile se aleg din lista de statusuri de comandă CS-Cart, asigurând consistența cu workflow-ul magazinului.

Procesare callback și actualizare comandă

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

• Primire parametri: amount, curr, invoice_id, ep_id, merch_id, action, message, approval, timestamp, nonce, fp_hash
• Verificare integritate: recalculare MAC (HMAC-MD5) cu cheia secretă și comparare cu fp_hash primit; în caz de nepotrivire răspunsul este „OK” fără modificarea comenzii (protecție anti-fraud)
• La action=0 (plată aprobată): fn_finish_payment și setare status conform „Status la plată aprobată”
• La plată eșuată/refuzată: setare status conform „Status la plată eșuată”, actualizare info plată pe comandă (transaction_id, reason_text)
• Răspuns „OK” către EuPlatesc pentru confirmarea primirii

invoice_id poate conține order_id sau order_id_repaid pentru comenzi refăcute; modulul extrage corect order_id pentru actualizare.

Date trimise către EuPlatesc

La inițierea plății, modulul trimite către EuPlatesc toate câmpurile necesare:

• Sumă (amount), monedă (curr), invoice_id, order_desc (ex: „Comanda #123”), merch_id, timestamp, nonce, fp_hash
• Date facturare: fname, lname, add, city, state, zip, country, phone, email
• Date livrare: sfname, slname, sadd, scity, sstate, szip, scountry (preluate din comanda CS-Cart)
• ExtraData: silenturl (callback), successurl, failedurl – cu sesiunea în URL pentru păstrarea autentificării la return
• Limbă (lang): ro sau en în funcție de limba coșului

Suma este convertită corect în moneda selectată (RON/EUR) folosind coeficienții de curs din CS-Cart.

Revenire client și rutare comandă

La revenirea de pe EuPlatesc (successurl / failedurl), modulul:

• Identifică comanda după order_id și action (success/fail) din URL
• Verifică că scriptul de plată este euplatesc.php pentru acea comandă
• Delegă rutarea (fn_order_placement_routines) pentru afișarea paginii de confirmare sau de eșec
• La inițierea plății, comanda este setată în status „În așteptare” (N) înainte de redirect

Licență și dependențe

Addon-ul depinde de netSEO Addons Manager pentru verificarea licenței. Codul de licență se configurează în setările modulului (secțiunea Licență). Actualizările pot fi gestionate prin Centrul de upgrade CS-Cart (connector NetseoEuplatesc).

Integrare nativă în CS-Cart

netSEO: EuPlatesc se integrează ca procesor de plată standard în CS-Cart: la activare se adaugă procesorul „EuPlatesc” în lista de procesori cu template pentru redirect (cc_outside) și admin template pentru MID, cheie secretă și monedă. Administratorul creează o metodă de plată, o asociază cu EuPlatesc și o oferă clienților la checkout.

Fără integrare EuPlatesc directă în CS-Cart, plățile online ar necesita procese manuale sau soluții intermediare. Acest add-on oferă redirect securizat, callback validat prin MAC, mapare clară a statusurilor și păstrarea sesiunii la return, într-un flux optimizat pentru e-commerce în România.