Integrare PayU România — gateway plăți cu Apple Pay și Google Pay
Integrăm PayU România (Prosper Capital) pe WooCommerce, PrestaShop, Magento, Next.js sau PHP custom. Hosted Order Page rapid sau Server-to-Server pentru flow custom. Comisioane 1.7-2.5%, fără fee inițial, settlement T+1.
Integrare PayU funcțională end-to-end, nu doar un plugin instalat
Configurare cont PayU + credentials
Te ghidăm la deschiderea contului de comerciant PayU România (acte firmă, IBAN, contract semnat digital), obținem credentials pentru sandbox și producție, configurăm POS-ul în panoul PayU cu URL-uri corecte pentru return, cancel și webhook IPN. Documentat pas cu pas pentru ca tu să poți modifica oricând.
Hosted Order Page sau Server-to-Server
Pentru livrare rapidă: Hosted Order Page (HOP) cu form POST și signed return URL — utilizatorul plătește pe pagina PayU, revine cu confirmare semnată. Pentru control total UX: Server-to-Server (S2S / LU) cu UI checkout custom în site, tokenizare card pe partea ta, decizie 3DS gestionată de tine. Alegem împreună după cerințe.
Webhook IPN cu validare signature
Endpoint dedicat care primește notificările PayU IPN, validează signature HMAC ca să fie sigur că vine de la PayU și nu de la un atacator, procesează idempotent (același IPN trimis de 5 ori nu duplică comanda), retry-safe (returnează 200 doar după ce a salvat statusul). Logging complet pentru audit ANAF.
Apple Pay + Google Pay activate
Configurăm domain verification pentru Apple Pay (fișier la /.well-known/apple-developer-merchantid-domain-association), butoanele Google Pay PaymentRequest API native, fallback elegant pe dispozitive nesupportate. Comisionul rămâne același ca pe card normal, dar conversion rate crește 15-25% pe mobile.
Sincronizare statusuri + refund flow
Mapăm corect statusurile PayU (New, Pending, Completed, Canceled, Rejected, Reversed) cu statusurile sistemului tău (WooCommerce, Magento, custom). Implementăm refund parțial / total din admin (apel API către PayU + actualizare comandă + email automat client). Funcționează și cu refund manual din panoul PayU.
Integrare SmartBill + e-Factura ANAF
Opțional: la confirmare plată PayU, generăm automat factura în SmartBill cu datele clientului, o trimitem pe email și o transmitem către ANAF e-Factura via SPV (obligatoriu B2B din 2024 și B2C din 2025). Reduce munca contabilă manuală cu 80-90% pentru e-commerce cu volum.
Audit securitate + 3DS Secure 2
Toate request-urile semnate și verificate, credentials păstrate în variabile de mediu (nu hardcodate în cod), 3DS Secure 2.0 activat (obligatoriu legal în UE din 2021), rate limiting pe endpoint webhook să nu fie spam-uit, log-uri criptate cu retenție 90 zile pentru audit.
Documentație + handoff complet
Manual scris cu: arhitectura integrării, endpoint-uri și signatures, credentials în vault Bitwarden / 1Password, diagramă webhook IPN, runbook pentru probleme comune, contacte suport PayU. Plus 1h video training cu echipa ta. 30 zile suport bug-uri inclus.
Cum funcționează
De la „vreau PayU pe site” la prima încasare reală în 2-4 săptămâni
Zilele 1-2
Discovery + alegere flow
Sesiune 30-45 min unde mapăm site-ul tău actual, fluxul de checkout, sistemele conectate (CRM, ERP, SmartBill), volumul lunar estimat, tipologia clienților (B2C, B2B, mix). Alegem împreună Hosted Order Page (livrare rapidă, UX standard PayU) sau Server-to-Server cu UI custom (mai mult timp, control total).
Zilele 3-5
Deschidere cont PayU + sandbox
Te asistăm la depunerea documentelor (CUI, IBAN, KYC reprezentant legal, contract operare PayU semnat digital). În paralel obținem credentials de sandbox și începem dezvoltarea. Aprobarea PayU durează 5-10 zile lucrătoare, dar putem dezvolta și testa complet pe sandbox între timp.
Zilele 6-12
Implementare + webhook IPN
Instalare plugin oficial (WooCommerce / PrestaShop / Magento) sau dezvoltare endpoint-uri custom (Next.js / PHP). Implementare server endpoint pentru creare order, handler webhook IPN cu validare signature, sincronizare status, refund flow, Apple Pay + Google Pay. Testare cu carduri sandbox.
Zilele 13-15
Testare end-to-end + edge cases
Rulăm 10+ scenarii reale: plată succes 3DS, plată succes fără 3DS (carduri vechi), refuz card, 3DS challenge eșuat, abandon checkout, refund parțial, refund total, webhook IPN întârziat, IPN duplicat, signature invalid. Validăm că fiecare scenariu duce la status corect în sistem.
Zilele 16-20
Go-live + monitoring
Switch credentials sandbox → producție, prima tranzacție reală de test cu cardul tău (1 RON), audit log-uri 24h, activare monitoring IPN (alertă dacă PayU trimite și serverul tău nu răspunde 200), email checklist către echipa ta cu ce să urmărească primele 2 săptămâni.
Stack suportat
Integrăm PayU pe orice stack folosit în România în 2026
WooCommerce
Plugin oficial PayU CEE
PrestaShop
Modul oficial PayU CEE
Magento 2
Extension oficial PayU
Next.js custom
S2S cu API REST PayU
Astro
Server endpoints proprii
WordPress headless
Backend PHP + REST
PHP custom / Laravel
SDK PayU PHP oficial
Shopify
Limitat — recomandăm Stripe
Detaliu tehnic
Hosted Order Page sau Server-to-Server — alegem după UX
Hosted Order Page (HOP)
Backend-ul tău creează un form POST către PayU cu parametrii comenzii și signature HMAC. Utilizatorul e redirectat pe pagina PayU unde introduce datele cardului, apoi revine pe site-ul tău cu un return URL semnat. În paralel, PayU trimite webhook IPN către serverul tău cu statusul final.
POST form → PayU page → signed return + IPN webhook
Server-to-Server (S2S / LU)
Frontend-ul tău (Next.js / React) colectează datele cardului via PayU Secure Form, le tokenizează direct la PayU (tu nu vezi PAN), apoi backend-ul face authorize + capture prin API REST PayU. 3DS challenge gestionat de tine. Webhook IPN obligatoriu pentru status final.
Secure form → token → REST authorize → IPN webhook
Webhook IPN e obligatoriu indiferent de flow — fără el riști să nu primești statusul final al unei tranzacții (return URL poate fi ratat dacă utilizatorul închide browserul). Implementăm întotdeauna handler IPN cu validare signature, procesare idempotentă și retry-safe.
Stack existent — plugin oficial = mai ieftin decât custom
Hosted Page vs S2S — S2S necesită UI checkout custom
Integrări adiacente — SmartBill, ANAF, CRM, ERP
Volum estimat — peste 5000 tranzacții/lună cere monitoring extra
Multi-currency sau marketplace — flow split + reconciliere
Mentenanță continuă — 0€ default, 30-80€/lună opțional
Întrebări frecvente
Ce ne întreabă firmele despre integrarea PayU România
Cât costă real o integrare PayU România și ce comisioane trag pe tranzacții?
Integrarea de la noi: 400-1200€ one-off pentru WooCommerce / Shopify standard (plugin oficial + configurare + testare), 800-1500€ pentru Next.js sau PHP custom cu S2S, 1500-2500€ pentru flow complex cu marketplace split sau subscriptions. PayU România nu cere fee inițial sau lunar pentru contul de comerciant — comisionul real pe tranzacție e 1.7-2.5% pe carduri RO/EU + 0.10-0.20 RON fix per tranzacție reușită. Apple Pay și Google Pay au același comision ca pe card. Settlement T+1 (banii ajung în contul tău a doua zi lucrătoare). Fără mentenanță obligatorie după go-live.
PayU vs NETOPIA vs Stripe — care e cel mai potrivit pentru magazinul meu?
PayU România: comisioane 1.7-2.5%, suport excelent în română, settlement T+1, popular pentru e-commerce mediu-mare în RO, Apple Pay și Google Pay incluse, hosted page solid. NETOPIA Payments: comisioane similare 1.8-2.5%, integrare puțin mai complicată, suport bun, popular pentru utilități și abonamente. Stripe: comision 1.4% EU + 0.25€ fix, internațional perfect, dar nu suportă carduri co-brand-uite local și nu are settlement RON nativ peste tot. Recomandare: PayU sau NETOPIA pentru clienți RO, Stripe dacă vinzi cross-border EU/global, sau toate trei dacă ai trafic mixt — costul integrării e marginal.
Cât durează integrarea PayU de la kickoff până la primul plată reală?
Pentru WooCommerce sau PrestaShop cu plugin oficial PayU: 3-5 zile lucrătoare (instalare, configurare credentials, testare în sandbox cu carduri test, switch în producție, testare end-to-end cu plată reală de 1 RON, audit log-uri webhook IPN). Pentru Next.js sau PHP custom cu S2S: 7-14 zile (UI checkout custom, server endpoint pentru creare comandă PayU, handler webhook IPN cu validare signature, retry logic, dashboard admin). Plus 5-10 zile la PayU pentru aprobare contul de comerciant (depinde de documentele firmei, ANAF, OCR ridicat dacă vinzi categorii reglementate). Total realist: 2-4 săptămâni calendaristice.
Ce face exact „integrarea” voastră — nu pot să-l pun singur din WooCommerce?
Tehnic, da, poți instala plugin PayU din repo WooCommerce și completa câmpuri. Practic, ce facem noi în plus: 1) Configurăm corect sandbox vs production (oameni se păcălesc des aici și încasează 0 RON o săptămână). 2) Validăm signature pe return URL ca un atacator să nu poată confirma o comandă fără să plătească. 3) Implementăm handler webhook IPN cu retry idempotent (PayU retrimite notificări dacă serverul tău nu răspunde 200 în 30s). 4) Sincronizăm statusurile PayU (Pending, Completed, Reversed, Refunded) cu statusurile WooCommerce / sistemul tău. 5) Setăm logging dedicat pentru audit ANAF și debugging. 6) Configurăm Apple Pay / Google Pay corect (cere validare separată domain). 7) Testare reală end-to-end cu 5+ scenarii (succes, eșec, abandon, refund, 3DS challenge).
Ce stack-uri suportați pentru integrare PayU — am Shopify, mai merge?
WooCommerce: plugin oficial PayU CEE, configurat și testat de noi. Shopify: PayU România nu are app oficial în Shopify App Store (limitare de partener Shopify, nu de la noi), deci recomandăm Stripe / Mollie pentru Shopify și PayU pentru WooCommerce / custom. PrestaShop: modul oficial PayU CEE disponibil, integrare standard. Magento 2: extension oficial PayU disponibil. Next.js / React custom: integrare server-side cu API PayU REST, webhook handler în route handler / API route, UI checkout custom cu Apple Pay și Google Pay PaymentRequest API. Astro / Nuxt: la fel ca Next.js, server endpoints proprii. WordPress headless: backend PHP cu plugin PayU + REST API către frontend. PHP custom / Laravel: SDK oficial PayU PHP, helper library disponibil.
Care sunt erorile comune la integrare PayU și cum le evităm?
Top 7 capcane văzute la clienți care veneau de la alte agenții: 1) Signature webhook IPN nu se validează — atacator trimite POST fals și marchează comanda plătită. 2) Endpoint webhook returnează 500 la prima procesare, dar codul tot scrie comanda — la retry-ul PayU se creează duplicate. 3) Mismatch între moneda contului (RON) și moneda din PayU request (EUR) — tranzacția eșuează silent. 4) Sandbox credentials lăsate în producție — lună de zile fără să încasezi nimic. 5) Apple Pay domain verification netrecută — buton apare dar nu funcționează. 6) Lipsă timeout / retry pe API call către PayU — clientul vede „eroare” deși plata e procesată. 7) Status mapping greșit între PayU și WooCommerce — comenzi rămân „Pending” pentru totdeauna. Toate acestea le acoperim default în integrarea noastră.
Ce suport tehnic primesc după go-live? Cine se ocupă dacă PayU schimbă API-ul?
Inclus în orice tarif: 30 zile suport bug-uri post-livrare (fix-uri gratuite pentru orice problemă cauzată de integrarea noastră), documentație scrisă cu credentials, endpoint-uri, fluxuri și diagrama webhook. Opțional, pachet mentenanță 30-80€/lună care include: monitoring webhook IPN (alertă dacă PayU trimite și serverul tău nu răspunde 200), update-uri când PayU lansează versiuni noi API (rare, 1-2 ori pe an), intervenții urgente sub 4h în timp lucrător. Schimbări majore API care necesită refacere mare: facturate ca proiect mic (200-500€). Documentația permite oricărui dev PHP/Node să intervină — nu te legăm doar de noi.
Când NU e potrivit PayU România și să aleg altceva?
Câteva scenarii unde recomandăm alternative: 1) Vinzi doar internațional, fără clienți RO — Stripe e mai potrivit (suport global, valute multiple nativ, fără cont separat per țară). 2) Ai volum mic (<200 tranzacții/lună) și vinzi servicii — PayPal / Revolut Business pot fi suficiente și mai ieftine. 3) Vinzi categorii cu risc (gambling, crypto, adult, suplimente OTC nereglementate) — PayU poate refuza aprobarea, mergi la Adyen sau procesatori specializați. 4) Vrei subscriptions / recurring complex cu trial-uri și upgrades — Stripe Billing e net superior, PayU subscriptions e limitat. 5) Ai marketplace cu multipli vânzători și ai nevoie de split payment automat — Mangopay sau Stripe Connect sunt special construite pentru asta. PayU rămâne cea mai bună alegere pentru e-commerce RO standard sub formă de B2C clasic.
Integrări conexe
PayU e o piesă — vezi celelalte integrări de plăți pe care le facem
Trimite-ne URL-ul site-ului actual, stack-ul folosit (WooCommerce, Next.js, etc.) și volumul estimat lunar. Primești ofertă scrisă cu tier, timeline și costuri în 4 ore.