POST/api/public/access-request/paypal/capture-order

Finalizează (capturează) o comandă creată anterior și aprobată de cumpărător în checkout-ul PayPal. Suma este stabilită exclusiv de server.

După ce cumpărătorul a aprobat plata la PayPal, trimiteți identificatorul comenzii returnat de `paypal/create-order` în câmpul `order_id`. În caz de succes, plata este finalizată, iar cererea de acces continuă să fie procesată. Cazuri de eroare: 400 `ORDER_ID_REQUIRED` (câmp lipsă), 404 `UNKNOWN_ORDER` (comandă necunoscută), 409 `CAPTURE_NOT_COMPLETED` (plata nu a fost încă aprobată — cumpărătorul trebuie să finalizeze checkout-ul PayPal) și 502 `PAYPAL_CAPTURE_FAILED` (eroare de comunicare cu PayPal). Apelați endpointul o singură dată per comandă.

Prezentare generală

Apel: POST /api/public/access-request/paypal/capture-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: order_id (body). Cazuri de eroare documentate: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Răspunsul exemplu de mai jos arată structura unui răspuns reușit în format JSON.

Autentificare și securitate

Nu este necesară autentificarea

Cel mult 10 cereri la fiecare 15 minute per adresă IP.

Idempotent: Nu

Parametri

order_id(body, string, obligatoriu)— Identificatorul comenzii PayPal returnat de `paypal/create-order`

Exemplu de cerere

{"order_id":"<PAYPAL_ORDER_ID>"}

Exemplu de răspuns

{"ok":false,"error":"UNKNOWN_ORDER","message":"Comandă necunoscută."}

Coduri de eroare

400 ORDER_ID_REQUIRED — Câmpul `order_id` lipsește.
404 UNKNOWN_ORDER — `order_id` nu este o comandă cunoscută creată anterior.
409 CAPTURE_NOT_COMPLETED — Cumpărătorul nu a aprobat încă plata.
502 PAYPAL_CAPTURE_FAILED — A apărut o eroare în comunicarea cu PayPal.

Comportament verificat

Fără `order_id`, apelul returnează 400 `ORDER_ID_REQUIRED`, cu o comandă necunoscută 404 `UNKNOWN_ORDER`. Cazul de succes necesită o plată reală PayPal aprobată de cumpărător.

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/create-orderCreează o comandă PayPal pentru pachetul selectat.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.

Articole similare

← Formulare publice