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

Vytvorí objednávku PayPal pre vybraný balík.

Odošlite kód balíka v poli `package` a voliteľne `email` žiadateľa. Sumu určuje výhradne server podľa balíka. Pri úspechu odpoveď obsahuje v objekte `data` ID objednávky PayPal `order_id`, ako aj `amount_cents` a `currency`; pomocou `order_id` kupujúci schváli platbu v checkoute PayPal. Potom platbu dokončíte cez `POST /api/public/access-request/paypal/capture-order`. Neplatný balík vedie k 400 `INVALID_PACKAGE`, neplatná e-mailová adresa k 400 `INVALID_EMAIL`. Ak je PayPal momentálne nedostupný, endpoint odpovie 503 `PAYPAL_NOT_READY`. Endpoint je obmedzený na 10 požiadaviek za 15 minút na jednu IP adresu. Každé úspešné volanie vytvorí novú objednávku; neopakujte ho automaticky.

Prehľad

Volanie: POST /api/public/access-request/paypal/create-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: package (body). Zdokumentované chybové prípady: 503 PAYPAL_NOT_READY. 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

Idempotentné: Nie

Parametre

package(body, string, povinné)— Kód vybraného balíka

Príklad požiadavky

{"package":"starter"}

Príklad odpovede

{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal je momentálne nedostupný."}

Chybové kódy

503 PAYPAL_NOT_READY — PayPal je momentálne nedostupný.

Overené správanie

Bez dostupného pripojenia na PayPal volanie vráti 503 `PAYPAL_NOT_READY`. Prípad úspechu vyžaduje skutočnú platbu cez PayPal.

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/capture-orderDokončí (capture) predtým vytvorenú objednávku schválenú kupujúcim v checkoute PayPal. Sumu určuje výhradne server.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