Ajutor: Stripe + S2S Backoffice V3 — Ghid de configurare plăți online

Acest ghid te ajută să conectezi Stripe la S2S Backoffice V3, astfel încât să poți insera linkuri de plată direct pe proforme și să primești notificări automate în Backoffice după ce clientul achită.

Rezumat (pentru cei grăbiți) #

  1. Creezi și colectezi 3 chei din Stripe:
    • Publishable key (cheie publică)
    • Restricted key (cheie restricționată)
    • Webhook signing secret (cheie semnare webhook)
  2. Configurezi un endpoint de webhook în Stripe cu URL-ul S2S (cu CUI-ul firmei tale la final) și evenimentul checkout.session.completed.
  3. Introduci cele 3 chei în Backoffice V3 → Configurări → Modalități de plată → Online.
  4. Activezi Stripe ca metodă de plată pentru Proforme, astfel încât linkul de plată să apară automat pe PDF.

Cerințe preliminare #

  • Cont Stripe creat și acces la secțiunea Developers.
  • Acces la S2S Backoffice V3 cu drepturi de configurare.
  • CUI-ul firmei (va fi folosit în URL-ul de webhook).

Notă despre modurile Stripe: Cheile diferă între Test și Live. După trecerea pe Live va trebui să folosești noile chei Live.

Pasul 1: Obținerea cheilor din Stripe #

  • Autentifică-te în Stripe și deschide meniul Developers (colțul stânga-jos).
  • Intră la API keys.
  • Publishable key (cheie publică):
    • Copiază Publishable key afișată. Dacă nu există, generează o Secret key — Stripe va crea și o Publishable key pereche. Salvează Publishable key în siguranță.
  • Restricted key:
  • Click Create restricted key.
  • Alege opțiunea “Providing this key to another website”, apoi Continue.
  • La Name scrie un nume sugestiv, ex.: S2S Backoffice.
  • La URL scrie: https://www.s2s.ro.
  • Click Create restricted key și finalizează eventualele verificări (email/2FA). Salvează cheia afișată — nu va mai fi vizibilă ulterior.

Important: Dacă se cere verificare pe email, deschide linkul din email într-un tab nou fără a închide tabul inițial din Stripe. După verificare, revino și finalizează generarea cheii.

Pasul 2: Configurarea Webhook-ului Stripe #

  • În Developers, deschide Webhooks.
  • Click Add endpoint și completează:
    • Endpoint URL: https://servicii.s2s-software.com/api/payment/stripe/webhook/XXXXXXXX
      înlocuiește XXXXXXXX cu CUI-ul firmei tale.
  • Click Select events și adaugă evenimentul:
    • checkout.session.completed Apoi Add events → verifică să apară în listă.
  • Confirmă cu Add endpoint.
  • În pagina endpointului, găsești Signing secret (se vede după Reveal). Click Reveal și salvează această cheie — va fi folosită în Backoffice.

Pasul 3: Introducerea cheilor în S2S Backoffice V3 #

  • Deschide Backoffice V3 → Configurări → Modalități de plată → fila Online.
  • Click Adaugă modalitate de plată online.
  • Completează câmpurile cu cele 3 chei:
    • Publishable key
    • Restricted key
    • Webhook signing secret
  • Click Salvează. În listă ar trebui să vezi Stripe activ.

Pasul 4: Afișarea linkului de plată pe Proforme (PDF) #

  • În Backoffice V3, mergi la Setări Proforma.
  • La Metoda online de plată, selectează Stripe.
  • Salvează. De acum, pe proformele generate, în partea de jos, se include linkul de plată pe care clientul poate da click și achita online.

Bune practici și securitate #

  • Păstrează cheile într-un manager de parole; nu le distribui pe email sau chat.
  • Diferă clar mediile Test și Live; etichetează configurările.
  • După trecerea pe Live, actualizează cheile în Backoffice și fă o plată reală de verificare.
  • Dacă modifici CUI-ul, regenerează configurarea după caz.

Depanare (Troubleshooting) #

  • Nu apare linkul pe Proformă: verifică la Setări Proforma că Stripe este selectat la Metoda online de plată.
  • Plata se face, dar nu vine notificarea: confirmă că endpointul de webhook are CUI corect, evenimentul checkout.session.completed este bifat și că Signing secret din Backoffice corespunde celui din Stripe.
  • Cheile nu mai pot fi copiate: în Stripe, regenerează cheia necesară și actualizează Backoffice (cheile vechi devin invalide).
  • Eroare permisiuni la Restricted key: recreează Restricted key conform pașilor de mai sus (scopul „Providing this key to another website”).

Ai nevoie de ajutor? #

Dacă întâmpini dificultăți, contactează suportul S2S sau revino la acest ghid și parcurge secțiunea de Depanare.

Încă nu ai testat programele noastre de gestiune?
Descarcă și încearcă!