Tutorial Stripe — configurare plată cu cardul
În acest tutorial vei învăța cum să îți creezi un cont Stripe și cum să obții cheile necesare pentru a accepta plăți cu cardul pe site-ul tău MyRentals.
Timp estimat: 10-15 minute
Pasul 1: Creează cont Stripe
- Accesează https://dashboard.stripe.com/register
- Completează adresa de email și parola
- Confirmă emailul primit
- Completează datele firmei tale (nume, adresă, CUI)
- Adaugă contul bancar unde vrei să primești banii
Notă: Stripe va cere documente pentru verificare (CUI, certificat de înregistrare, etc.). Procesul durează 1-2 zile lucrătoare.
Pasul 2: Activează modul Test (recomandat la început)
Înainte să mergi pe live, recomandăm să testezi cu modul de test.
- În colțul din dreapta sus, vei vedea un toggle “Test mode”
- Activează-l (devine portocaliu)
În acest mod toate plățile sunt simulate, nu se încasează bani reali.
Pasul 3: Obține Publishable Key și Secret Key
- În meniul din stânga: Developers → API keys
- Vei vedea două chei:
- Publishable key — începe cu
pk_test_...(saupk_live_...) - Secret key — începe cu
sk_test_...(sausk_live_...)
- Publishable key — începe cu
- Click pe “Reveal test key” la Secret Key și copiaz-o
⚠️ Atenție: Secret Key-ul nu îl da nimănui niciodată. Tratează-l ca pe o parolă.
Pasul 4: Configurează Webhook-ul
Webhook-ul este modul prin care Stripe ne anunță când plata e reușită.
- În meniul din stânga: Developers → Webhooks
- Click pe “Add endpoint”
- La Endpoint URL lipește URL-ul afișat în panoul tău MyRentals (în pagina de configurare Stripe)
- Exemplu:
https://numefirma.myrentals.ro/index.php?route=payment/stripe/webhook
- Exemplu:
- La Select events to listen to:
- Click pe “Select events”
- Caută și bifează doar
checkout.session.completed
- Click pe “Add endpoint”
Pasul 5: Obține Webhook Signing Secret
După ce ai creat webhook-ul:
- Click pe webhook-ul nou creat din listă
- În secțiunea “Signing secret” click pe “Reveal”
- Copiază valoarea (începe cu
whsec_...)
Pasul 6: Configurează în MyRentals
În panoul tău MyRentals:
- Mergi la Metode de plată
- Instalează Stripe (dacă nu e deja instalat)
- Completează:
- Mod: Test (pentru testare) sau Live (pentru producție)
- Publishable Key: din Pasul 3
- Secret Key: din Pasul 3
- Webhook Signing Secret: din Pasul 5
- Activează Status și salvează
Pasul 7: Testează plata
În modul Test poți folosi următoarele carduri:
| Card | Număr | Rezultat |
|---|---|---|
| Plată reușită | 4242 4242 4242 4242 |
✅ Plata acceptată |
| Fonduri insuficiente | 4000 0000 0000 0341 |
❌ Plata refuzată |
Pentru toate cardurile:
- Expirare: orice dată viitoare (ex:
12/30) - CVC: orice 3 cifre (ex:
123) - Cod poștal: orice (ex:
12345)
Pasul 8: Trecere pe Live
Când ești gata să accepți plăți reale:
- În Stripe Dashboard, dezactivează “Test mode” (toggle stânga sus)
- Repetă Pașii 3, 4 și 5 pentru cheile Live (
pk_live_...,sk_live_...,whsec_...) - În MyRentals, schimbă modul din Test în Live și actualizează cele 3 chei
- Important: webhook-ul de test și cel live sunt separate — trebuie să creezi webhook nou pentru Live!
Probleme frecvente
“Plata e procesată dar rezervarea nu apare”
→ Verifică webhook-ul în Stripe Dashboard → Developers → Webhooks. Dacă apare cu eroare 4xx/5xx, verifică Webhook Signing Secret.
“Cardul nu este acceptat”
→ În Test mode, folosește doar cardurile de test din Pasul 7. Cardurile reale nu funcționează în Test.
“Stripe cere documente pe care nu le am”
→ Contactează direct suport Stripe la support.stripe.com. Ei te ghidează cu ce e necesar pentru tipul tău de business.