POST/api/public/access-request/paypal/capture-order
Dokončí (capture) predtým vytvorenú objednávku schválenú kupujúcim v checkoute PayPal. Sumu určuje výhradne server.
Po tom, čo kupujúci schváli platbu v PayPal, odošlite ID objednávky vrátené z `paypal/create-order` v poli `order_id`. Pri úspechu je platba dokončená a žiadosť o prístup sa ďalej spracúva. Chybové prípady: 400 `ORDER_ID_REQUIRED` (chýba pole), 404 `UNKNOWN_ORDER` (neznáma objednávka), 409 `CAPTURE_NOT_COMPLETED` (platba ešte neschválená – kupujúci musí dokončiť checkout PayPal) a 502 `PAYPAL_CAPTURE_FAILED` (chyba komunikácie s PayPal). Endpoint volajte pre každú objednávku len raz.
Prehľad
Volanie: POST /api/public/access-request/paypal/capture-order. Tento endpoint patrí do skupiny „Verejné formuláre“ API aplikácie Zentor App. Je verejne dostupný a nevyžaduje žiadnu autentifikáciu. Volanie nie je idempotentné: Každé úspešné volanie akciu spustí znova. Povinné parametre: order_id (body). Zdokumentované chybové prípady: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Ukážková odpoveď nižšie zobrazuje štruktúru úspešnej odpovede vo formáte JSON.
Autentifikácia a zabezpečenie
Nevyžaduje sa žiadna autentifikácia
Najviac 10 požiadaviek za 15 minút na jednu IP adresu.
Idempotentné: Nie
Parametre
order_id(body, string, povinné)— ID objednávky PayPal vrátené z `paypal/create-order`Príklad požiadavky
{"order_id":"<PAYPAL_ORDER_ID>"}Príklad odpovede
{"ok":false,"error":"UNKNOWN_ORDER","message":"Neznáma objednávka."}Chybové kódy
400 ORDER_ID_REQUIRED — Chýba pole `order_id`.404 UNKNOWN_ORDER — `order_id` nie je známa, predtým vytvorená objednávka.409 CAPTURE_NOT_COMPLETED — Kupujúci platbu ešte neschválil.502 PAYPAL_CAPTURE_FAILED — Pri komunikácii s PayPal nastala chyba.Overené správanie
Bez `order_id` volanie vráti 400 `ORDER_ID_REQUIRED`, pri neznámej objednávke 404 `UNKNOWN_ORDER`. Prípad úspechu vyžaduje skutočnú platbu PayPal schválenú kupujúcim.
Verejné formuláre
POST /api/public/contactPrijíma dotaz z kontaktného formulára na webe Zentor App a odovzdáva ho tímu Zentor.POST /api/public/consultationPrijíma žiadosť o poradenstvo z formulára na webe Zentor App.POST /api/public/access-requestOdošle žiadosť o prístup k balíku (Starter, Individuálny alebo 14-dňové Demo). Vyžaduje sa predtým potvrdená e-mailová adresa.POST /api/public/access-request/email/start-verificationOdošle šesťmiestny potvrdzovací kód platný 10 minút na uvedenú e-mailovú adresu – prvý krok žiadosti o prístup.POST /api/public/access-request/email/verifySkontroluje kód doručený e-mailom a vydá potvrdzovací token pre následnú žiadosť o prístup.GET /api/public/access-request/payment-statusUdáva, ktoré platobné metódy (PayPal, Stripe) sú aktuálne dostupné pre žiadosť o prístup.GET /api/public/access-request/paypal/configVracia verejnú konfiguráciu PayPal (aktívne, režim, mena) pre platobný krok.POST /api/public/access-request/paypal/create-orderVytvorí objednávku PayPal pre vybraný balík.POST /api/public/access-request/stripe/create-checkoutVytvorí platobnú relaciu Stripe Checkout pre vybraný balík.POST /api/public/activate-accountAktivuje novo vytvorený používateľský účet a nastaví prvé heslo – spustené cez odkaz v pozývacom e-maile.