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

Maakt een PayPal-bestelling aan voor het gekozen pakket.

Stuur de pakketcode in het veld `package` en optioneel het `email` van de aanvrager. Het bedrag wordt uitsluitend serverzijdig uit het pakket bepaald. Bij succes bevat het antwoord in het object `data` het PayPal-bestelnummer `order_id` plus `amount_cents` en `currency`; met de `order_id` keurt de koper de betaling goed in de PayPal-checkout. Daarna rondt u de betaling af met `POST /api/public/access-request/paypal/capture-order`. Een ongeldig pakket leidt tot 400 `INVALID_PACKAGE`, een ongeldig e-mailadres tot 400 `INVALID_EMAIL`. Is PayPal momenteel niet beschikbaar, dan antwoordt het endpoint met 503 `PAYPAL_NOT_READY`. Het endpoint is beperkt tot 10 aanvragen per 15 minuten per IP-adres. Elke succesvolle aanroep maakt een nieuwe bestelling aan; herhaal deze niet automatisch.

Overzicht

Aanroep: POST /api/public/access-request/paypal/create-order. Dit endpoint hoort bij de groep ‘Openbare formulieren’ van de API van Zentor App. Het is openbaar toegankelijk en vereist geen authenticatie. De aanroep is niet idempotent: elke geslaagde aanroep activeert de actie opnieuw. Verplichte parameters: package (body). Gedocumenteerde foutgevallen: 503 PAYPAL_NOT_READY. Het voorbeeldantwoord hieronder toont de opbouw van een geslaagd antwoord in JSON-formaat.

Auth & beveiliging

Geen authenticatie vereist

Idempotent: Nee

Parameters

package(body, string, vereist)— Pakketcode van het gekozen pakket

Voorbeeld-request

{"package":"starter"}

Voorbeeld-response

{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal is momenteel niet beschikbaar."}

Foutcodes

503 PAYPAL_NOT_READY — PayPal is momenteel niet beschikbaar.

Geverifieerd gedrag

Zonder beschikbare PayPal-koppeling geeft de aanroep 503 `PAYPAL_NOT_READY`. Het succesgeval vereist een echte betaling via PayPal.

Openbare formulieren

POST /api/public/contactOntvangt een aanvraag uit het contactformulier van de Zentor App-website en stuurt deze door naar het Zentor-team.POST /api/public/consultationOntvangt een adviesaanvraag uit het formulier van de Zentor App-website.POST /api/public/access-requestDient een toegangsaanvraag in voor een pakket (Starter, Individueel of 14-daagse demo). Een vooraf bevestigd e-mailadres is vereist.POST /api/public/access-request/email/start-verificationStuurt een zescijferige bevestigingscode, 10 minuten geldig, naar het opgegeven e-mailadres — de eerste stap van een toegangsaanvraag.POST /api/public/access-request/email/verifyControleert de per e-mail verzonden code en geeft een bevestigingstoken af voor de daaropvolgende toegangsaanvraag.GET /api/public/access-request/payment-statusGeeft aan welke betaalmethoden (PayPal, Stripe) momenteel beschikbaar zijn voor de toegangsaanvraag.GET /api/public/access-request/paypal/configGeeft de publieke PayPal-configuratie (actief, modus, valuta) voor de betaalstap.POST /api/public/access-request/paypal/capture-orderRondt een eerder aangemaakte en door de koper in de PayPal-checkout goedgekeurde bestelling af (capture). Het bedrag wordt uitsluitend door de server vastgesteld.POST /api/public/access-request/stripe/create-checkoutMaakt een Stripe-checkoutsessie aan voor het gekozen pakket.POST /api/public/activate-accountActiveert een nieuw aangemaakt gebruikersaccount en stelt het eerste wachtwoord in — geactiveerd via de link in de uitnodigingse-mail.

Gerelateerde artikelen

← Openbare formulieren