Trimite plăți din aplicația ta
O adresă și o cheie pentru integrarea ta, la care aplicația proprie trimite plata încasată și primește factura.
Dacă încasezi prin altceva decât Stripe, aplicația ta poate trimite plata direct. Alegi Aplicația ta la crearea integrării și primești o adresă și o cheie. Restul, de la TVA la serie și până la trimiterea în SPV, funcționează exact ca la Stripe.
Este singurul punct de intrare pentru un program din afară. API-ul general nu există încă, iar interfața pe care o folosește browserul nu este publică.
Cererea
Un POST la adresa integrării, cu cheia în antetul X-Connector-Key și corpul în JSON.
{
"externalId": "ORD-1024",
"occurredAt": "2026-09-09T10:12:00Z",
"currency": "RON",
"reference": "Bon 1024",
"buyer": {
"name": "Sc Alpha Srl",
"cif": "12345678",
"email": "[email protected]"
},
"lines": [
{ "name": "Abonament lunar", "quantity": 1, "amount": 121.00 }
]
}| Câmp | Obligatoriu | Ce înseamnă |
|---|---|---|
externalId | Da | Identificatorul tău pentru plată. Trimis de două ori, produce o singură factură |
occurredAt | Nu | Momentul încasării. Lipsă, se ia momentul cererii |
currency | Nu | Implicit RON |
amount | Nu | Doar dacă nu trimiți linii. Trimis alături de ele, trebuie să fie egal cu suma lor |
lines[].amount | Da | Totalul liniei, cu sau fără TVA după regula aleasă pe integrare |
buyer.cif | Nu | Prezența lui face cumpărătorul persoană juridică pe factură |
reference | Nu | Numărul tău de document, afișat pe rândul plății |
Răspunsul
Plata este înregistrată și, dacă nu ai pus întârziere, factura se emite pe loc. Răspunsul conține starea plății și, când există deja, numărul facturii. O adresă greșită și o cheie greșită dau același răspuns, 404.
Ce nu face
- Nu citește nimic. Facturile emise le vezi în aplicație sau le scoți prin export.
- Nu anulează și nu stornează. O plată returnată se rezolvă cu un storno făcut de un om.
- Nu ține catalogul de produse. Liniile vin cu numele lor din cererea ta.
Cheia se vede o singură dată
La creare, și la fiecare reemitere. Nu poate fi citită înapoi, doar înlocuită, iar reemiterea oprește imediat cheia dinainte.
Netopia, EuPlătesc și Shopify urmează. Spune-ne care îți trebuie și pentru ce volum.
Cere o integrare gata făcută