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.

Súvisiace články

← Verejné formuláre