POST/api/public/access-request/paypal/capture-order
Rondt een eerder aangemaakte en door de koper in de PayPal-checkout goedgekeurde bestelling af (capture). Het bedrag wordt uitsluitend door de server vastgesteld.
Nadat de koper de betaling bij PayPal heeft goedgekeurd, stuurt u het door `paypal/create-order` geretourneerde bestelnummer in het veld `order_id`. Bij succes is de betaling afgerond en wordt de toegangsaanvraag verder verwerkt. Foutgevallen: 400 `ORDER_ID_REQUIRED` (veld ontbreekt), 404 `UNKNOWN_ORDER` (geen bekende bestelling), 409 `CAPTURE_NOT_COMPLETED` (betaling nog niet goedgekeurd — koper moet de PayPal-checkout afronden) en 502 `PAYPAL_CAPTURE_FAILED` (communicatiefout met PayPal). Roep het endpoint per bestelling slechts één keer aan.
Overzicht
Aanroep: POST /api/public/access-request/paypal/capture-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: order_id (body). Gedocumenteerde foutgevallen: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Het voorbeeldantwoord hieronder toont de opbouw van een geslaagd antwoord in JSON-formaat.
Auth & beveiliging
Geen authenticatie vereist
Maximaal 10 aanvragen per 15 minuten per IP-adres.
Idempotent: Nee
Parameters
order_id(body, string, vereist)— PayPal-bestelnummer geretourneerd door `paypal/create-order`Voorbeeld-request
{"order_id":"<PAYPAL_ORDER_ID>"}Voorbeeld-response
{"ok":false,"error":"UNKNOWN_ORDER","message":"Onbekende bestelling."}Foutcodes
400 ORDER_ID_REQUIRED — Het veld `order_id` ontbreekt.404 UNKNOWN_ORDER — `order_id` is geen bekende, eerder aangemaakte bestelling.409 CAPTURE_NOT_COMPLETED — De koper heeft de betaling nog niet goedgekeurd.502 PAYPAL_CAPTURE_FAILED — Er is een fout opgetreden bij de communicatie met PayPal.Geverifieerd gedrag
Zonder `order_id` geeft de aanroep 400 `ORDER_ID_REQUIRED`, bij een onbekende bestelling 404 `UNKNOWN_ORDER`. Het succesgeval vereist een echte, door de koper goedgekeurde PayPal-betaling.
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/create-orderMaakt een PayPal-bestelling aan voor het gekozen pakket.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.