Cum integrezi Netopia într-un magazin online PHP — tutorial 2026

Netopia e cel mai folosit procesator de plăți cu cardul în România (după 2024 când ROMCARD s-a integrat sub umbrela lor). Dacă ai magazin online, e probabil să-l integrezi. Iată cum.

1. Cont și credențiale

Contractezi cu Netopia (account manager dedicat). Primești:

• API Key — secret pentru autentificare
• POS Signature — identifică magazinul tău
• Sandbox URL — pentru testare (https://sandboxsecure.mobilpay.ro)
• Production URL — pentru live (https://secure.mobilpay.ro)

2. Flow plată (cum funcționează)

1. Clientul apasă „Plătește" pe magazinul tău
2. Backend-ul tău cheamă API Netopia v2/payment/card/start cu orderID, amount, billing
3. Netopia returnează paymentURL — redirect clientul acolo
4. Client introduce datele de pe card (3DS dacă e cazul)
5. Netopia trimite IPN (server-to-server) pe URL-ul tău /payment/ipn
6. Verifici signature, marchezi comanda ca paid în DB
7. Client e redirect pe returnUrl al tău cu thank-you page

3. Cod minim (PHP)

4. IPN handler (server-to-server confirmation)

Netopia trimite POST la URL-ul tău cu rezultatul plății. Trebuie să:

1. Verifici signature-ul (HMAC) ca să nu accepți IPN-uri false
2. Returnezi HTTP 200 cu JSON {"errorCode":0} sau Netopia reîncearcă
3. Actualizezi statusul comenzii în DB doar dacă status = „confirmed"

5. Recurring (plăți cu binding)

Pentru abonamente: la prima plată trimiți createBinding: true. La success Netopia returnează un bindingId. Pentru taxarea automată ulterioară, folosești endpoint-ul v2/payment/card/recurrent cu bindingId în loc de datele cardului.

6. Erori comune

• „Invalid signature": API key sau POS signature greșite — verifică în panou Netopia
• „Order already exists": refolosești orderID — generează unul nou de fiecare dată
• IPN nu vine: URL-ul tău trebuie HTTPS public, fără auth. Verifică firewall

7. Ce facem la devERP

Avem integrare Netopia gata-făcută în toate magazinele noastre (vezi /servicii/ecommerce) — cu wrapper PHP propriu, retry logic, audit log, dashboard în admin.

Vrei să integrăm noi la tine? Modul „Plăți online (Netopia/Stripe)" în configurator — 390€.