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

Sluit 'n voorheen geskepte en deur die koper in die PayPal-afhandeling vrygegewe bestelling af (Capture). Die bedrag bepaal slegs die bediener.

Stuur die deur `paypal/create-order` verskafde bestel-ID in die veld `order_id`, nadat die koper die betaling by PayPal vrygegee het. By sukses is die betaling afgehandel en die toegangsaanvraag word verder verwerk. Foutgevalle: 400 `ORDER_ID_REQUIRED` (veld ontbreek), 404 `UNKNOWN_ORDER` (geen bekende bestelling), 409 `CAPTURE_NOT_COMPLETED` (betaling nog nie vrygegee – die koper moet die PayPal-afhandeling voltooi) en 502 `PAYPAL_CAPTURE_FAILED` (kommunikasiefout met PayPal). Roep die eindpunt slegs een keer per bestelling op.

Oorsig

Oproep: POST /api/public/access-request/paypal/capture-order. Hierdie eindpunt behoort tot die groep “Openbare vorms” van die Zentor App-API. Dit is publiek toeganklik en vereis geen verifikasie nie. Die oproep is nie idempotent nie: elke suksesvolle oproep aktiveer die aksie opnuut. Verpligte parameters: order_id (body). Gedokumenteerde foutgevalle: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Die voorbeeldrespons hieronder toon die struktuur van ’n suksesvolle respons in JSON-formaat.

Verifikasie en sekuriteit

Geen verifikasie vereis nie

Hoogstens 10 versoeke per 15 minute per IP-adres.

Idempotent: Nee

Parameters

order_id(body, string, vereis)— PayPal-bestel-ID gelewer deur `paypal/create-order`

Voorbeeldversoek

{"order_id":"<PAYPAL_ORDER_ID>"}

Voorbeeldrespons

{"ok":false,"error":"UNKNOWN_ORDER","message":"Unbekannte Bestellung."}

Foutkodes

400 ORDER_ID_REQUIRED — Die veld `order_id` ontbreek.
404 UNKNOWN_ORDER — `order_id` is nie 'n bekende, voorheen geskepte bestelling nie.
409 CAPTURE_NOT_COMPLETED — Die koper het die betaling nog nie vrygestel nie.
502 PAYPAL_CAPTURE_FAILED — By die kommunikasie met PayPal het 'n fout voorgekom.

Gekontroleerde gedrag

Sonder `order_id` lewer die oproep 400 `ORDER_ID_REQUIRED`, met 'n onbekende bestelling 404 `UNKNOWN_ORDER`. Die suksesgeval verg 'n werklike, deur die koper vrygestelde PayPal-betaling.

Openbare vorms

POST /api/public/contactNeem 'n versoek van die kontakvorm van die Zentor App-webwerf in ontvangs en stuur dit aan die Zentor-span deur.POST /api/public/consultationNeem 'n konsultasieversoek van die vorm van die Zentor App-webwerf in ontvangs.POST /api/public/access-requestDien 'n toegangsaanvraag vir 'n pakket in (Starter, Individueel of 14-dae-demo). Voorvereiste is 'n voorheen bevestigde e-posadres.POST /api/public/access-request/email/start-verificationStuur 'n sescijferkode, 10 minute geldig, aan die verstrekte e-posadres – die eerste stap van 'n toegangsaanvraag.POST /api/public/access-request/email/verifyKontroleer die kode wat per e-pos afgelewer is en gee 'n bevestigingstoken uit vir die daaropvolgende toegangsaanvraag.GET /api/public/access-request/payment-statusDui aan welke betaalmetodes (PayPal, Stripe) tans vir die toegangsaanvraag beskikbaar is.GET /api/public/access-request/paypal/configLewer die openbare PayPal-konfigurasie (aktief, modus, geldeenheid) vir die betaalstap.POST /api/public/access-request/paypal/create-orderSkep 'n PayPal-bestelling vir die gekose pakket.POST /api/public/access-request/stripe/create-checkoutSkep 'n Stripe-afrekeningsessie vir die gekose pakket.POST /api/public/activate-accountAktiveer 'n nuut aangelegde gebruikersrekening en stel die eerste wagwoord – ontlok via die skakel in die uitnodigings-e-pos.

Verwante artikels

← Openbare vorms