POST/api/public/access-request/paypal/create-order
Creează o comandă PayPal pentru pachetul selectat.
Trimiteți codul pachetului în câmpul `package` și, opțional, `email`-ul solicitantului. Suma este determinată exclusiv pe server, în funcție de pachet. În caz de succes, răspunsul conține, în obiectul `data`, identificatorul comenzii PayPal `order_id`, precum și `amount_cents` și `currency`; cu `order_id`, cumpărătorul aprobă plata în checkout-ul PayPal. Finalizați apoi plata cu `POST /api/public/access-request/paypal/capture-order`. Un pachet invalid duce la 400 `INVALID_PACKAGE`, o adresă de e-mail invalidă la 400 `INVALID_EMAIL`. Dacă PayPal este momentan indisponibil, endpointul răspunde cu 503 `PAYPAL_NOT_READY`. Endpointul este limitat la 10 cereri la fiecare 15 minute per adresă IP. Fiecare apel reușit creează o comandă nouă; nu îl repetați automat.
Prezentare generală
Apel: POST /api/public/access-request/paypal/create-order. Acest endpoint aparține grupului „Formulare publice” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul nu este idempotent: fiecare apel reușit declanșează din nou acțiunea. Parametri obligatorii: package (body). Cazuri de eroare documentate: 503 PAYPAL_NOT_READY. Răspunsul exemplu de mai jos arată structura unui răspuns reușit în format JSON.
Autentificare și securitate
Nu este necesară autentificarea
Idempotent: Nu
Parametri
package(body, string, obligatoriu)— Codul pachetului selectatExemplu de cerere
{"package":"starter"}Exemplu de răspuns
{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal nu este disponibil în prezent."}Coduri de eroare
503 PAYPAL_NOT_READY — PayPal este momentan indisponibil.Comportament verificat
Fără o conexiune PayPal disponibilă, apelul returnează 503 `PAYPAL_NOT_READY`. Cazul de succes necesită o plată reală prin PayPal.
Formulare publice
POST /api/public/contactPrimește o solicitare din formularul de contact al site-ului Zentor App și o transmite echipei Zentor.POST /api/public/consultationPrimește o solicitare de consultanță din formularul site-ului Zentor App.POST /api/public/access-requestTrimite o cerere de acces pentru un pachet (Starter, Individual sau demo de 14 zile). Este necesară o adresă de e-mail confirmată anterior.POST /api/public/access-request/email/start-verificationTrimite un cod de confirmare din șase cifre, valabil 10 minute, la adresa de e-mail indicată — primul pas al unei cereri de acces.POST /api/public/access-request/email/verifyVerifică codul trimis prin e-mail și emite un token de confirmare pentru cererea de acces ulterioară.GET /api/public/access-request/payment-statusIndică ce metode de plată (PayPal, Stripe) sunt disponibile în prezent pentru cererea de acces.GET /api/public/access-request/paypal/configOferă configurația publică PayPal (activ, mod, monedă) pentru pasul de plată.POST /api/public/access-request/paypal/capture-orderFinalizează (capturează) o comandă creată anterior și aprobată de cumpărător în checkout-ul PayPal. Suma este stabilită exclusiv de server.POST /api/public/access-request/stripe/create-checkoutCreează o sesiune de checkout Stripe pentru pachetul selectat.POST /api/public/activate-accountActivează un cont de utilizator nou creat și stabilește prima parolă — declanșat prin linkul din e-mailul de invitație.