Integrare Stripe
Ultima modificare 3h
Configurează plata online cu cardul pe proformele și facturile tale. La final, clienții achită direct din PDF cu un buton, iar încasarea se înregistrează automat în iFlows.
CUM FUNCȚIONEAZĂ
- Generezi documentul — activezi butonul de plată pe o proformă sau factură și generezi PDF-ul.
- Trimiți clientului — trimiți documentul prin mijloacele obișnuite ale platformei.
- Clientul achită — plătește cu cardul pe pagina Stripe, iar încasarea se înregistrează automat.
| 💡 De reținut: Link-ul de plată se generează doar pentru documente exprimate în moneda implicită a platformei. |
ÎNAINTE DE A ÎNCEPE
Ai nevoie, în esență, de un singur lucru din contul tău Stripe — cheia secretă:
- Cheia secretă (Secret Key) — începe cu sk_test_ (test) sau sk_live_ (real). Cheia publică pk_ nu este acceptată.
- Cont de comerciant Stripe activ — din care obții cheia; nu e nevoie de altă configurare prealabilă.
- (Opțional) Webhook Secret — whsec_…; în majoritatea cazurilor se configurează automat la conectare.
- (Opțional) Cont bancar — contul în care se înregistrează încasările; dacă îl lași gol, se creează automat.
Pasul 1 Pregătește contul Stripe
📍 Cont Stripe → Developers → API keys
Intră în contul tău Stripe și deschide zona pentru cheile de acces (Developers → API keys). Copiază Secret Key — este singura valoare de care ai nevoie pentru a conecta iFlows.
| 💡 Recomandare: testează întâi cu o cheie sk_test_. Când totul funcționează, o înlocuiești cu cheia reală sk_live_ din „Setări Integrare”. |
| ⚠️ Atenție: nu folosi cheia publică pk_… — platforma o respinge. Tratează cheia secretă ca pe o parolă. |
Pasul 2 Instalează integrarea în iFlows
📍 Setări → Integrări → Disponibile
Mergi la Setări → Integrări, deschide tab-ul Disponibile și apasă pe cardul Stripe.
▸ Tab-ul „Disponibile” — apasă pe Stripe pentru a deschide fereastra de conectare.
Completează fereastra de conectare și apasă Activează:
▸ Fereastra „Integrare Stripe” — completează cheia secretă și activează integrarea.
| Secret Key (obligatoriu) | Cheia secretă din Stripe; începe cu sk_test_ sau sk_live_. |
| Webhook Secret (opțional) | Lasă gol — platforma încearcă să configureze automat. Îl completezi manual doar dacă înregistrarea automată eșuează. |
| Cont Bancar Tranzacții (opțional) | Contul în care se înregistrează încasările. Gol → se creează automat un cont nou. |
| Buton „Activează” | Salvează și activează integrarea. Erorile (cheie invalidă/lipsă) apar în fereastră. |
Integrarea apare acum în Integrările mele, împreună cu modalitatea de plată „Plata Stripe”, creată automat — pe ea apar toate încasările prin card.
Pasul 3 Verifică și gestionează integrarea
📍 Setări → Integrări → Instalate (rândul Stripe)
După instalare, pe rândul Stripe ai trei butoane de acțiune:
▸ Cele trei butoane de pe rândul Stripe și rolul fiecăruia.
Apasă Generează link de plată de test pentru a verifica rapid că legătura cu Stripe funcționează — fără a crea un document real.
▸ Test reușit — link-ul demonstrativ confirmă că integrarea este operațională.
Din Setări Integrare poți schimba oricând cheia, contul bancar sau codul de notificare.
▸ „Setări Integrare” — lasă Secret Key gol pentru a păstra cheia curentă; Webhook URL este afișat doar informativ.
| ❗ Șterge Integrare: elimină conexiunea. După ștergere, opțiunea „Include Link pentru Plată” nu mai apare pe proforme și facturi (dacă nu ai instalată o altă integrare de plată). |
Pasul 4 Adaugă link-ul de plată pe documente
📍 Vânzări → Facturi Proforme / Facturi → Opțiuni Export PDF
Deschide o proformă sau o factură în formular, derulează la secțiunea Opțiuni Export PDF și activează comutatorul Include Link pentru Plată. Dacă ai mai multe integrări de plată, alege Stripe din selector. Salvează, apoi generează PDF-ul din lista de documente.
▸ Secțiunea „Opțiuni Export PDF” cu „Include Link pentru Plată” activat și procesatorul Stripe selectat.
| ⚠️ Butonul apare în PDF doar dacă, simultan: integrarea Stripe e instalată · documentul e în moneda implicită · totalul e mai mare ca zero · clientul are completate ATÂT emailul, CÂT ȘI telefonul. Altfel butonul nu apare, iar la salvare apare un mesaj care cere datele de contact lipsă. |
| 💡 De reținut: link-ul se creează la generarea PDF-ului, nu la salvarea documentului. Poți activa comutatorul implicit și din șablonul PDF, pentru ca documentele noi să-l aibă pornit. |
Pasul 5 Clientul plătește cu cardul
📍 PDF-ul documentului → pagina securizată Stripe
În PDF-ul generat apare butonul verde „Achită cu cardul”:
▸ PDF-ul proformei cu butonul „Achită cu cardul”. Suma, moneda și datele clientului sunt preluate automat.
Clientul apasă butonul și ajunge pe pagina securizată Stripe, unde emailul este deja precompletat. Introduce datele cardului și finalizează plata:
▸ Pagina de plată Stripe — emailul clientului este precompletat, iar descrierea conține tipul, seria și numărul documentului.
Pasul 6 Încasarea se înregistrează automat
📍 În fundal, după confirmarea Stripe
Dacă legătura de notificare (Webhook) este configurată, Stripe trimite automat confirmarea către platformă, iar încasarea se înregistrează în fundal:
- La o factură emisă se înregistrează o încasare cu metoda Plata Stripe, iar factura devine Achitată.
- La o proformă încasarea este înregistrată ca avans (sold favorabil clientului); proforma rămâne fără statutul de factură achitată.
| ❗ Important: înregistrarea automată funcționează doar cu Webhook Secret configurat. Dacă lipsește, link-ul se generează și clientul poate plăti, dar încasarea trebuie înregistrată manual. |
PARTICULARITĂȚI IMPORTANTE & DEPANARE
- Link valabil 24 de ore — după 24h link-ul nu mai e valabil; regenerezi PDF-ul → se creează un link nou.
- Modificarea documentului → link nou — generările repetate ale unui document nemodificat refolosesc același link; modificarea produce unul nou.
- După achitare, butonul dispare — regenerarea unui document deja plătit nu mai produce link — se împiedică o a doua plată.
- Doar moneda implicită — dacă butonul lipsește deși opțiunea e activată, verifică moneda documentului.
- Email ȘI telefon obligatorii — platforma cere ambele date ale clientului, deși pe pagina Stripe se folosește efectiv doar emailul.
- Confirmarea depinde de Webhook — înregistrarea automată a plății funcționează doar cu codul de notificare configurat.
- Proforme ≠ facturi — plata unei facturi o marchează Achitată; plata unei proforme se înregistrează ca avans.
- Selectorul de procesator — apare doar cu două sau mai multe integrări de plată; cu una singură, Stripe e ales automat.