Ce primesti
Setam impreuna contul Euplatesc in panoul de admin: URL retur HTTPS, URL notify pentru callback server-to-server, secret key generat in panou, brand name vizibil pe pagina checkout. Verificare ca toate setarile sunt productive si nu raman pe modul test la go-live.
Construim payload-ul cu parametrii in ordinea exacta documentata (amount, currency, invoice_id, order_desc, merchant_id, timestamp, nonce) si calculam signature HMAC SHA256 cu secretul tau pe backend. Niciodata in browser, niciodata cu secret hardcodat in cod public.
Endpoint callback la /api/euplatesc/callback care: 1) valideaza signature returnata cu secretul tau, 2) verifica epstatus == '00' pentru succes, 3) actualizeaza comanda in DB doar dupa validare server-side, 4) raspunde Euplatesc cu OK pentru a opri retry-urile, 5) logheaza tot pentru audit.
Suport complet 3DS Secure 2 (obligatoriu PSD2 in UE din 2022). Testare cu carduri de test furnizate de Euplatesc: card challenge frictionless, card challenge cu OTP, card declined la authentication. Verificam ca flow-ul redirect functioneaza pe mobile si desktop, atat Chrome cat si Safari iOS.
Daca ai SaaS sau abonamente, implementam recurring billing via Euplatesc: salvare token card la prima tranzactie, cronjob lunar pentru charge automat, handling failed payments cu dunning email, oprire subscription dupa 3 retry-uri esuate. Integrare cu Stripe Billing nu necesara, Euplatesc o face nativ.
Implementam buton refund in panoul admin: full refund (sumarul integral), partial refund (suma editabila pentru disputes partiale), refund cu motiv pentru tracking. API call catre /api/refund cu validare server-side. Logica de business: nu permite refund peste suma originala, blocheaza refund duplicat.
Integrare cu endpoint Euplatesc /reports pentru export zilnic CSV / JSON cu toate tranzactiile. Reconciliere automata in DB-ul tau: matching intre comenzi platite si tranzactii reusite, alerta daca exista discrepante (ex: comanda paid in DB dar tranzactie refused la Euplatesc).
Livrabil final: README cu pasii exacti pentru cum se face refund, cum se reseteaza secret key, cum se schimba URL callback, cum se citeste log-ul tranzactiilor. Plus playbook pentru echipa ta de operations: ce face daca o tranzactie ramane stuck, cum gestionezi dispute-uri, cand contactezi suport Euplatesc.
Cum functioneaza
01
Stabilim impreuna stack-ul existent (WooCommerce, Next.js, custom), volumul lunar estimat de tranzactii si tipul de fluxuri necesare (one-off, subscriptions, marketplace split). Daca nu ai inca contract BCR Pay, te conectam cu reprezentantul BCR si te ghidam prin documentele necesare (CUI, certificat constatator, IBAN business).
02
Primesti din panoul Euplatesc merchant_id si secret_key pentru environment-ul de test (sandbox). Configuram .env in proiect cu separare clara test vs productie. Variabilele de productie raman doar la tine, noi lucram exclusiv cu test in dezvoltare.
03
Cream butonul Plateste cu card pe pagina cos / checkout. La click, backend-ul construieste payload-ul cu amount in format 2 zecimale (ex: 99.00), currency RON, invoice_id unic generat de tine, order_desc cu lista produse. Calcul HMAC SHA256 si POST catre gateway.euplatesc.ro/order/payment.
04
Implementam /api/euplatesc/callback ca endpoint POST care primeste notificarea de la Euplatesc. Validare signature returnata, verificare epstatus, update status comanda in DB. Niciodata trustam parametrii din URL de retur user-side (poate fi manipulati), doar callback server-to-server e trusted.
05
Test cu setul oficial de carduri furnizate de Euplatesc: card success (epstatus 00), card declined (insufficient funds), card 3DS challenge frictionless, card 3DS challenge cu OTP. Verificam ca toate scenariile sunt gestionate corect, inclusiv timeout si retry. Test si pe mobile, nu doar desktop.
06
Trecere pe environment de productie cu credentials reali. Primele 3 tranzactii reale le facem noi cu card propriu (sume mici 1-10 RON) pentru a confirma flow-ul. Refund-uim imediat cele 3 sume. Daca totul e ok, sistemul e activ pentru clientii tai. Monitorizare extinsa primele 7 zile.
Stack suportat
3-5 zile
Plugin oficial pe wordpress.org. Configurare credentials, mapping campuri checkout, testare cu carduri furnizate. Recomandat pentru majoritatea magazinelor WP.
4-7 zile
Nu exista app oficiala. Implementam via Shopify Payments Apps API sau redirect catre hosted page Euplatesc cu return URL configurat in admin Shopify.
3-5 zile
Modul oficial Euplatesc disponibil in PrestaShop addons. Compatibil cu PrestaShop 1.7 si 8.x. Suport multi-shop si multi-currency unde activat.
5-8 zile
Modul oficial Magento Marketplace. Lucram cu el si extindem cu logica de subscription daca ai modelul B2B sau marketplace cu split payments.
7-10 zile
Integrare app/api/euplatesc/* cu route handlers Next.js 15+. Signature HMAC pe Node runtime, callback server-only cu validare, types stricti pentru epstatus.
6-9 zile
Endpoints API in src/pages/api/ cu hybrid rendering. Lucreaza cu adapter Node sau Cloudflare Pages (atentie: HMAC necesita Node runtime, nu edge pur).
8-12 zile
WP backend cu plugin Euplatesc activ + frontend Next.js care declanseaza checkout via WP REST API. Callback se gestioneaza pe WP, sincronizare comenzi via webhook.
6-10 zile
Integrare cu cURL si openssl_hmac in service class. Job pentru recurring billing in scheduler. Pachet Composer custom pentru reutilizare in proiecte multiple.
6-9 zile
Express sau Fastify cu middleware HMAC. Recommendat pattern: service Euplatesc separat de controller, types in TypeScript pentru toate response-urile API.
Preturi
350-500€
3-5 zile
600-900€
7-10 zile
900-1200€
10-15 zile
Intrebari frecvente
Implementare one-off intre 350€ si 1200€ in functie de stack si scope. Cel mai ieftin scenariu (350-500€): site WooCommerce sau Shopify cu plugin oficial, doar configurare credentials + testare. Mediu (600-900€): integrare custom Next.js / PHP cu signature HMAC SHA256, response handler cu validare epstatus, recurring si refund implementate. Scump (900-1200€): aplicatie SaaS B2B cu subscriptions recurrente, partial refunds programatice, sincronizare cu SmartBill / ANAF e-Factura, panou admin custom. Mentenanta lunara 0-50€/luna in functie de volum tickets. Fees Euplatesc se platesc direct catre BCR, nu trec prin noi: 1.4-2.0% pentru parteneri BCR, 1.9-2.5% pentru clienti fara cont BCR.
Euplatesc are cele mai mici fees pentru clientii BCR (1.4-2.0% vs 1.9-2.3% NETOPIA, 1.4% + 0.25€ Stripe). Daca ai deja cont business BCR si vinzi predominant in RON catre carduri romanesti, Euplatesc e matematic cel mai ieftin. NETOPIA e mai bun daca ai nevoie de mai multe metode de plata (Apple Pay, Google Pay, card to card, BT iPay) intr-un singur dashboard. Stripe e obligatoriu daca vinzi international si vrei suport multi-currency real, dar te taxeaza 2% suplimentar pentru carduri non-EU. Pentru un magazin tipic ro cu sub 5000 comenzi/luna, recomandarea noastra e Euplatesc daca esti la BCR, NETOPIA altfel.
Pentru WooCommerce sau Shopify cu plugin oficial: 3-5 zile lucratoare de la momentul in care primim credentials test (merchant ID, secret key) si avem acces la admin. Pentru integrare custom Next.js sau aplicatie PHP: 7-12 zile in functie de complexitate (signature HMAC, response handler, recurring, refund flow). Timpul include staging environment, testare cu 4 carduri de test furnizate de Euplatesc (success, failure, 3DS challenge, insufficient funds), QA manual al fluxului end-to-end si documentatie pentru echipa ta. Cronometrul porneste dupa ce semnam contractul de integrare BCR (durata uzuala 5-10 zile lucratoare pentru parteneri noi).
Concret: 1) Configuram merchant account in panoul Euplatesc (URL retur, URL notify, secret key, brand). 2) Implementam butonul checkout care construieste payload-ul cu amount, currency, order_id si genereaza signature HMAC SHA256 cu secretul tau. 3) Submit POST catre gateway.euplatesc.ro/order/payment cu form-data corecta. 4) Implementam response handler la URL-ul callback care valideaza signature returnata si verifica epstatus (00 = succes, restul = esec). 5) Marcam comanda platita in DB doar dupa validare server-side (niciodata client-side). 6) Setam flow-uri pentru refund (full sau partial), recurring (pentru subscriptions) si raportare zilnica via API /reports. 7) Testare cu carduri de test + 3 tranzactii reale low-amount in productie.
WooCommerce: plugin oficial Euplatesc Payment Gateway disponibil pe wordpress.org, configurare in 2-3 ore, lucram cu el daca clientul deja are. Shopify: nu exista app oficiala Euplatesc, dar implementam via Shopify Payments Apps API sau redirect catre hosted page Euplatesc (4-6 zile). PrestaShop si Magento: module oficiale Euplatesc disponibile, lucram cu ele. Next.js / Astro / Remix: integrare custom via API REST cu Node.js handler in app/api/euplatesc/*, signature HMAC SHA256, callback validation server-side. PHP custom (Laravel, Symfony, vanilla): integrare directa cu cURL si openssl_hmac. WordPress headless: WP backend cu plugin Euplatesc + frontend Next.js care declanseaza checkout via REST.
Top 5 erori vazute la clienti: 1) Signature mismatch — ordinea parametrilor in stringul HMAC nu e cea documentata (amount, currency, invoice_id, merchant_id in ordinea exacta). Rezolvare: verificare byte-by-byte vs documentatie oficiala. 2) Response handler care nu valideaza signature returnata — atacatorul poate forta comanda paid via curl. Rezolvare: validare obligatorie server-side. 3) URL retur si URL notify cu typo sau pe HTTP — Euplatesc refuza endpoint-uri non-HTTPS in productie. 4) Amount in format gresit (virgula vs punct, lipsa zecimale) — Euplatesc cere mereu doua zecimale cu punct. 5) Testare insuficienta a flow-ului 3DS Secure 2 challenge — recommendat min 5 tranzactii test cu cardul 3DS simulat.
Garantie de stabilitate 60 zile inclusa in implementare: orice bug aparut in flow-ul de plata (signature, callback, refund, recurring) il fixam fara cost suplimentar. Dupa garantie, plan mentenanta optional 30-50€/luna care include: monitoring activ al endpoint-urilor callback (alerta in 5 minute daca pica), update-uri la schimbari API Euplatesc (rare, dar se intampla 1-2 ori pe an), suport email cu SLA fix in 24h pentru issues critice, training echipa ta pentru gestiunea refund-urilor si dispute-urilor. Fara mentenanta: lucram pe ora 50€/h cu prioritate 2-5 zile dupa cerere.
Nu recomand Euplatesc in 4 scenarii clare: 1) Vinzi predominant international (UK, US, Germania) — Stripe e mult mai bun pentru multi-currency, 3DS regional si dispute management. 2) Ai nevoie de Apple Pay si Google Pay native ca diferentiator — NETOPIA are integrare mai matura, Euplatesc le suporta dar prin redirect. 3) Esti SaaS B2B cu modele complexe de pricing (usage-based, tiered, metered) — Stripe Billing e gandit pentru asta, Euplatesc recurring e basic. 4) Volum sub 50 tranzactii/luna — fees fixe lunare Euplatesc (10€/luna minimum la unele tier-uri) nu se justifica, mai bine PayPal Business sau Revolut Business invoicing. Pentru toate astea iti recomandam direct alternativa potrivita.
Integrari conexe
Toate gateway-urile suportate de noi — Euplatesc, NETOPIA, Stripe, PayU, BT iPay. Comparativ complet, recomandare in functie de stack si volum.
Alternativa puternica la Euplatesc cu suport Apple Pay si Google Pay nativ. Fees 1.9-2.3%, dashboard mai matur pentru multi-method payments.
Solutia recomandata daca vinzi international. Multi-currency real, dispute management excelent, Stripe Billing pentru SaaS B2B complex.