Integrare Netopia Payments pe orice stack, live in 5-10 zile
Conectam Netopia (fost mobilPay) la magazinul tau: API v3.0 cu signature HMAC SHA512, 3DS, callback IPN, recurring, Apple Pay si Google Pay. Sandbox testat, decontare T+1 in BCR/BRD/ING/Raiffeisen/BT. Cod sursa documentat, fara vendor lock-in.
Integrare Netopia completa, nu doar buton de plata pe pagina
Initiere plata cu signature HMAC SHA512
POST /payment/card/start cu payload semnat HMAC SHA512 folosind cheia privata Netopia. request_id unic generat de tine pentru mapping intern intre comanda si tranzactie. Validare amount, currency RON/EUR, billing details client. Suport returnURL pentru redirect post-plata.
3DS si autentificare emisiune banca
Toate cardurile trec prin 3D Secure 2.0 (obligatoriu PSD2 in UE din 2021). Redirect catre banca emitenta pentru OTP SMS, biometric sau push app. Frictionless flow pentru cardurile cu istoric (35-40% fara challenge). Handling pentru carduri fara 3DS (rar, declined automat).
Callback handler + IPN reconciliation
Endpoint POST securizat care primeste confirmation de la Netopia (status: confirmed, paid, canceled, credit). Verificare signature pe response. Cron job orar care verifica tranzactiile in pending via GET /payment/{request_id}/status — IPN ratat nu mai e problema. Logging Sentry pentru audit.
Recurring + one-click pentru abonamente
Tokenizare card la prima plata (PCI compliant, tokenul stocat la Netopia, nu la tine). Plati recurente automate lunare/anuale fara interactiunea clientului. One-click checkout pentru reveniri — clientul nu mai introduce datele. Ideal pentru SaaS, abonamente, servicii lunare, membership.
Apple Pay + Google Pay + Visa/MC
Visa si Mastercard (credit + debit) toate tipurile. Apple Pay si Google Pay activate cu un click — checkout 2-3 secunde de pe mobil cu Face ID/Touch ID. Conversion rate cu 15-30% mai mare pe mobil cu wallets vs intrare manuala. Maestro acceptat. American Express la cerere (fees mai mari).
Integrare SmartBill + ANAF e-Factura
Dupa plata confirmata: emitere automata factura SmartBill sau Oblio (API), trimitere e-Factura ANAF pentru B2B (obligatoriu din 2024), email client cu PDF atasat, arhivare in Drive/Dropbox/S3. Tot fluxul de la plata pana la factura legala in maxim 30 secunde, fara interventie manuala.
Refund + partial refund din admin
Panou admin custom sau direct in WooCommerce/Shopify de unde poti emite refund total sau partial fara sa intri in Netopia. Refund-ul ajunge la client in 5-10 zile lucratoare (banca emitenta dicteaza). Logging complet cu user audit (cine a facut refund, cand, motiv). Stornare factura SmartBill automata.
Cod sursa documentat + sandbox
Toata implementarea ramane la tine: cod sursa pe GitHub/GitLab, documentatie tehnica markdown cu flow diagrams, postman collection pentru API testing, mediu sandbox functional cu carduri de test Netopia, instructiuni deploy. Orice dev poate intra in cod si intelege fluxul in 30 minute.
Cum functioneaza
De la onboarding cont Netopia la prima plata reala in 5-10 zile
Zilele 1-2
Onboarding cont Netopia + KYC
Ajutam la setup cont merchant Netopia: KYC documente firma (CUI, certificat ONRC, IBAN), contract signat digital, configurare merchant ID si chei API in panel Netopia. Daca ai deja cont mobilPay vechi, migrarea catre Netopia v3 e gratuita si pastreaza istoricul tranzactiilor.
Zilele 3-5
Implementare tehnica API v3.0
POST /payment/card/start cu signature HMAC SHA512 calculat corect pe payload canonic JSON. Generare request_id unic per comanda (UUID v4 sau prefix-comandaID). Setup returnURL pentru redirect dupa 3DS. Endpoint callback POST securizat cu verificare signature pe raspuns. Mapping status Netopia in baza ta.
Zilele 6-7
Testare sandbox cu carduri de test
Testare end-to-end in mediul sandbox Netopia cu carduri de test oficiale (4111 1111 1111 1111 cu CVV 123): plati success, plati declined, 3DS challenge, callback ratat, retry, refund. Verificam toate edge cases inainte de live. Tu testezi flow-ul ca user, noi monitorizam logs.
Ziua 8
Cron IPN reconciliation + monitoring
Setup cron job orar care verifica tranzactiile in status pending via GET /payment/{request_id}/status — captureaza plati unde IPN-ul s-a pierdut. Sentry integration pentru erori callback. Dashboard cu metrici: success rate, average value, declines per ora, alertare pe drop brutal de conversie.
Ziua 9
Trecere live + monitorizare 48h
Switch din sandbox la productie cu chei live Netopia, prima tranzactie reala test 1 RON cu cardul tau, monitorizare intensiva 48h cu alerting pe orice anomalie. Tu vezi banii in cont T+1 sau T+2 in ING/BCR/BRD/BT. Documentatie tehnica si video walkthrough livrate.
Ziua 10
Training echipa + handover
Sesiune 1h cu echipa ta: cum vezi tranzactiile in panel Netopia, cum faci refund din admin shop, cum interpretezi raportul lunar de decontari, cum recunosti chargeback si ce faci. 30 zile suport bug-uri inclus dupa handover. Optional pachet mentenanta 50€/luna pentru monitoring continuu.
Stack suportat
Integram Netopia indiferent pe ce ruleaza shop-ul tau
WooCommerce
Plugin oficial
Plugin oficial Netopia mobilPay, free, intretinut activ. Config in 1-2 ore daca tema nu e personalizata exotic. Suport recurring via WooCommerce Subscriptions.
Shopify
Via Worker custom
Shopify nu accepta Netopia nativ ca payment provider. Solutie: Custom Payment Method + middleware Cloudflare Worker care proxy-aza catre Netopia API.
PrestaShop
Modul comunitar
Modul Netopia comunitar functional, customizam in functie de versiunea PrestaShop (1.7.x sau 8.x) si tema. Integrare cu pachete livrare si OPC.
Magento 2
Extensie comerciala
Extensie Netopia pentru Magento 2.4+, suport multi-store si multi-currency. Recomandata pentru cataloage cu peste 5000 produse si trafic mare.
Next.js custom
SDK Node nativ
Implementare directa cu Route Handlers App Router 16, signature HMAC in Edge Runtime, callback handler verificat type-safe TypeScript, deploy Vercel sau Cloudflare.
Astro
API endpoint
Astro nu are backend persistent, deci API endpoint catre Cloudflare Worker sau Node server separat care procesează callback. Recomandat pentru shop-uri mici-medii.
WordPress headless
REST proxy
Frontend Next.js/Astro + backend WordPress headless. Plugin Netopia ruleaza pe WP, expune REST endpoints catre frontend. Best of both worlds: viteza + flexibilitate.
PHP custom
SDK PHP oficial
SDK PHP oficial Netopia cu composer, signature generation cu openssl_sign(), suport pentru aplicatii legacy Laravel, Symfony, CodeIgniter sau cod custom.
Detaliu tehnic
Cum arata fluxul tehnic NETOPIA in productie
POST /payment/card/start
Initierea platii cu signature HMAC SHA512 calculat pe payload canonic (amount, currency, request_id, returnURL, billing). Server-side, niciodata din browser. Response include URL de redirect 3DS catre banca emitenta.
callback POST + confirmation
Endpoint securizat care primeste status final (confirmed, paid, canceled, credit). Verificam signature pe response inainte de orice action. Idempotency pe request_id pentru retry-uri Netopia. Logging audit Sentry.
request_id mapping
UUID v4 unic per comanda, stocat in baza ta inainte de POST start. Permite mapping cert intre tranzactie Netopia si comanda ta in toate scenariile (callback ratat, refresh client, retry banca).
IPN handling + reconciliation
Cron orar verifica tranzactiile in pending via GET /payment/{request_id}/status. Captureaza plati unde IPN-ul s-a pierdut (server down, timeout, network glitch). Garanteaza zero pierderi de reconciliere intre Netopia si shop.
Stack-ul existent: plugin oficial WP e fast, Shopify via Worker custom e mai mult
Recurring si one-click checkout necesita logica suplimentara state management
Integrare SmartBill/Oblio/ANAF e-Factura: +100-300€ peste baseline
Multi-currency RON/EUR si conversie FX: +200-400€
Migrare istoric din alt provider (Stripe, PayU) catre Netopia: cost separat
Fraud detection custom cu Sift/Riskified: +500-1500€ implementare
Intrebari frecvente
Ce ne intreaba firmele inainte de integrare Netopia
Cat costa de fapt sa procesezi plati prin Netopia — fees reale 2026?
Netopia Payments practica fees procentuale: 1.6-2.0% pentru carduri emise in Romania (Visa/Mastercard BCR, BRD, ING, Raiffeisen, Banca Transilvania), 2.2-2.5% pentru carduri straine, plus 0.30 RON taxa fixa per tranzactie aprobata. Fara abonament lunar pentru conturile standard, fara setup fee. Pentru volume mari (peste 100k RON/luna) poti negocia 1.4-1.7%. Apple Pay si Google Pay au acelasi fee ca tokenul card-ului sursa. Tranzactiile esuate sunt gratuite. Decontare la T+1 sau T+2 in contul tau ING/BCR/BT/etc.
Netopia vs Stripe vs PayU pentru o firma din Romania — cand alegi care?
Netopia (fost mobilPay): cel mai potrivit pentru piata RO, fees mici pe carduri locale (1.6-2%), suport in romana, integrare directa cu SmartBill si Oblio pentru facturare, decontare rapida in lei. Stripe: best UI/UX, API curat, Stripe Radar pentru fraud, dar fees 1.5% + 0.25 EUR pe tranzactie europeana si decontare doar EUR sau prin Wise. PayU: bun pentru pay-by-link si BNPL (rate fara dobanda), fees similare Netopia. Recomandare: Netopia pentru e-commerce RO clasic, Stripe pentru SaaS cu plati recurente internationale, PayU daca vrei rate Tbi/Raiffeisen integrate.
Cat dureaza integrarea Netopia si ce primesc la final?
Pentru un magazin standard: 5-10 zile lucratoare end-to-end. Etape: ziua 1-2 onboarding cont Netopia (KYC, contract, IBAN, configurare merchant in panel), ziua 3-5 implementare tehnica (POST /payment/card/start cu signature, callback handler, IPN reconciliation), ziua 6-7 testare sandbox cu carduri de test Netopia, ziua 8 trecere live cu monitorizare 48h. Primesti cod sursa documentat, mediu sandbox functional, dashboard tranzactii configurat, GDPR cookie consent ajustat, training 1h pentru echipa, 30 zile suport bug-uri.
Ce face exact integrarea? Doar buton de plata sau mai mult?
Integrarea completa acopera: 1) Initiere plata (POST /payment/card/start cu signature HMAC SHA512, request_id unic generat de tine pentru mapping intern). 2) Redirect 3DS catre banca emitenta pentru autorizare. 3) Callback handler POST de la Netopia cu status final (confirmed, paid, canceled, credit). 4) IPN reconciliation: cron job care verifica tranzactiile sub-confirmate la fiecare 5 min via API status. 5) Update comanda in ERP/CRM/baza ta. 6) Email confirmare client cu factura SmartBill atasata. 7) Refund handling din panou admin. 8) Logging complet pentru audit ANAF.
Pe ce stack lucrati — WooCommerce, Shopify, Next.js, custom?
Suportam orice. WooCommerce: plugin oficial Netopia mobilPay (free, intretinut activ), config in 1-2 ore daca tema nu e personalizata exotic. Shopify: gateway alternativ via Custom Payment Method + middleware Cloudflare Worker (Shopify nu accepta Netopia nativ ca payment provider direct). PrestaShop si Magento: module comunitare existente, customizate la nevoie. Next.js custom: implementare directa SDK Node/TypeScript cu route handlers App Router. Astro si WordPress headless: API routes catre backend Node/PHP. PHP custom legacy: SDK PHP oficial Netopia, signature generation cu openssl.
Erori comune Netopia si cum le evitam?
Top 5 erori vazute: 1) Signature invalida (HMAC SHA512 calculat gresit pe payload, frecvent din encoding UTF-8 inconsistent) — fix: serializare canonica JSON inainte de hash. 2) Callback ratat (IPN trimis dar serverul tau era down) — fix: cron reconciliation orar via GET /payment/{request_id}/status. 3) request_id duplicat (regenerat la refresh) — fix: idempotency key in baza ta. 4) Carduri 3DS care esueaza silent — fix: redirect status check, nu te baza doar pe callback async. 5) Reconciliere lipsa intre Netopia decontare si comenzi shop — fix: export zilnic CSV vs comenzi paid.
Aveti suport tehnic dupa go-live? Ce se intampla cand pica ceva?
Da, suport tehnic real, nu doar ticket-uri ignorate. Pachet baza: 30 zile bug-fix gratuit post-livrare, raspuns email max 24h, fix critic (plati blocate) max 4h. Pachet mentenanta lunara 50€/luna: monitoring uptime endpoint callback, alertare automata pe Slack/email daca rate-ul de plati esuate creste, update SDK Netopia cand publica versiuni noi, audit security semestrial, suport prioritar 4h SLA. Pentru e-commerce mari peste 1000 tranzactii/luna recomandam pachet Custom cu monitorizare 24/7 si on-call.
Cand NU e potrivit Netopia si ce alternative recomandati?
Netopia NU e potrivit pentru: 1) SaaS B2B international cu abonamente USD/EUR — Stripe e clar superior pentru recurring multi-currency. 2) Marketplace cu split payments catre mai multi vanzatori — Stripe Connect sau Mangopay sunt gandite pentru asta. 3) Plati la nivel international predominant (sub 30% trafic RO) — Stripe ofera UX mai bun. 4) Crypto sau metode exotice de plata — Netopia nu suporta. 5) Volume foarte mari (peste 1M RON/luna) unde fees-urile conteaza — negociaza si cu Libra Pay sau direct cu banca pentru POS virtual cu fee sub 1%.
Trimite-ne URL-ul magazinului si stack-ul actual (WooCommerce, Shopify, Next.js sau custom). In 4 ore primesti oferta scrisa cu timeline si pret fix, fara surprize.