md2pdf/pluxee-todo.md

To‑do list pentru plata cu cardurile profesorilor (Pluxee / Prima de carieră)

Împărțit în:

• A. Client (deținător website)
• B. Tu (partea tehnică)

---

A. Client – ce are de făcut

1. Clarifică programul

   • Confirmă că se lucrează cu cardurile Pluxee pentru „Prima de carieră didactică / profesională".
   • Verifică la inspectorat / finanțator dacă este impus un anumit procesator (ex. „BT eComm / EuPlătesc", „Netopia" etc.).

2. Devino comerciant afiliat Pluxee

   • Completează formularul pentru comercianți Pluxee:
     • https://www.pluxee.ro/beneficii-comercianti/
   • Specifică clar că vrei să accepți carduri pentru Prima de carieră didactică / profesională.
   • Semnează contractul și confirmă că firma este în rețeaua de „locații afiliate".

3. Alege procesatorul de plăți

   • Cere oferte comerciale de la minimum 2–3 procesatori:
     • NETOPIA Payments – https://netopia-payments.com
     • EuPlătesc – https://www.euplatesc.ro/
     • PayU România – https://romania.payu.com/oferta-companii/
     • (opțional) PlatiOnline – https://plati.online/parteneri/
     • (opțional) BT eCommerce – https://www.bancatransilvania.ro/companii/solutii-de-plata
   • Negociază:
     • comision carduri standard,
     • comision carduri de beneficii (Pluxee).
   • Semnează contractul cu procesatorul ales.

4. Predă către developer tot ce e necesar

   • Date firmă (CUI, denumire, adresă, email contact).
   • Acces la contul de comerciant al procesatorului.
   • Credențiale tehnice (Merchant ID, API key / signature etc.).
   • Documentația oficială / linkul de „Developers" al procesatorului.
   • Decizia clară: „Acesta este procesatorul pe care îl folosim".

---

B. Tu (developer) – ce ai de făcut

1. Clarificări inițiale

   • Confirmă cu clientul:
     • ce procesator a ales,
     • dacă există restricții impuse de inspectorat / finanțator.
   • Verifică că firma este sau va fi afiliată Pluxee (altfel nu are sens integrarea pentru aceste carduri).

2. Documentație procesator

   • Ia linkul oficial de documentație:
     • NETOPIA – secțiunea „Developers" (Payment API / redirect).
     • EuPlătesc – ghid integrator din contul de comerciant.
     • PayU – https://developers.payu.com/europe/
     • PlatiOnline – https://wiki.plati.online/index.php/PlatiOnline_API_-_software_developers
   • Notează cerințele lor minime (ce URL‑uri trebuie să expui, ce parametri trebuie trimiși, cum se validează semnătura).

3. Integrare la nivel de produs (high‑level)

   • Decide împreună cu clientul:
     • cum se numește metoda de plată în checkout (ex. „Plată online cu cardul (inclusiv card profesor)").
     • în ce punct al flow‑ului se pornește plata (final de checkout).
   • Planifică:
     • URL pentru inițiere plată,
     • URL pentru return (success/error),
     • URL pentru notificare server‑to‑server (IPN / webhook).

4. Testare & go‑live

   • Configurează mediul de test/sandbox al procesatorului.
   • Fă tranzacții de test (carduri de test).
   • După mutarea în producție:
     • Fă 1–2 tranzacții reale cu un card Pluxee (sume mici).
     • Confirmă cu clientul că:
       • plățile apar în rapoartele procesatorului,
       • plățile apar și în interfața Pluxee (dacă e cazul),
       • site‑ul activează corect comenzile.

5. Monitorizare inițială

   • Monitorizează primele zile:
     • erori de plată,
     • rata de succes a tranzacțiilor,
     • eventuale refuzuri specifice cardurilor de beneficii,
   • Ajustează împreună cu procesatorul dacă apar probleme de configurare (MCC, limite etc.).

---