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

Finalise (capture) une commande précédemment créée et approuvée par l'acheteur dans le checkout PayPal. Le montant est fixé exclusivement par le serveur.

Après que l'acheteur a approuvé le paiement chez PayPal, envoyez l'identifiant de commande renvoyé par `paypal/create-order` dans le champ `order_id`. En cas de succès, le paiement est finalisé et la demande d'accès est traitée plus avant. Cas d'erreur : 400 `ORDER_ID_REQUIRED` (champ manquant), 404 `UNKNOWN_ORDER` (commande inconnue), 409 `CAPTURE_NOT_COMPLETED` (paiement non encore approuvé – l'acheteur doit terminer le checkout PayPal) et 502 `PAYPAL_CAPTURE_FAILED` (erreur de communication avec PayPal). N'appelez le point de terminaison qu'une seule fois par commande.

Vue d'ensemble

Appel : POST /api/public/access-request/paypal/capture-order. Ce point de terminaison appartient au groupe « Formulaires publics » de l'API de Zentor App. Il est accessible publiquement et ne nécessite aucune authentification. L'appel n'est pas idempotent : chaque appel réussi déclenche à nouveau l'action. Paramètres obligatoires : order_id (body). Cas d'erreur documentés : 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. L'exemple de réponse ci-dessous montre la structure d'une réponse réussie au format JSON.

Authentification et sécurité

Aucune authentification requise

Au maximum 10 requêtes par 15 minutes et par adresse IP.

Idempotent: Non

Paramètres

order_id(body, string, requis)— Identifiant de commande PayPal renvoyé par `paypal/create-order`

Exemple de requête

{"order_id":"<PAYPAL_ORDER_ID>"}

Exemple de réponse

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

Codes d'erreur

400 ORDER_ID_REQUIRED — Le champ `order_id` est manquant.
404 UNKNOWN_ORDER — `order_id` n'est pas une commande connue créée précédemment.
409 CAPTURE_NOT_COMPLETED — L'acheteur n'a pas encore approuvé le paiement.
502 PAYPAL_CAPTURE_FAILED — Une erreur est survenue lors de la communication avec PayPal.

Comportement vérifié

Sans `order_id`, l'appel renvoie 400 `ORDER_ID_REQUIRED`, avec une commande inconnue 404 `UNKNOWN_ORDER`. Le cas de succès requiert un vrai paiement PayPal approuvé par l'acheteur.

Formulaires publics

POST /api/public/contactReçoit une demande provenant du formulaire de contact du site web Zentor App et la transmet à l'équipe Zentor.POST /api/public/consultationReçoit une demande de conseil provenant du formulaire du site web Zentor App.POST /api/public/access-requestSoumet une demande d'accès pour une formule (Starter, Sur mesure ou démo de 14 jours). Une adresse e-mail préalablement confirmée est requise.POST /api/public/access-request/email/start-verificationEnvoie un code de confirmation à six chiffres, valable 10 minutes, à l'adresse e-mail indiquée – première étape d'une demande d'accès.POST /api/public/access-request/email/verifyVérifie le code envoyé par e-mail et délivre un jeton de confirmation pour la demande d'accès suivante.GET /api/public/access-request/payment-statusIndique quels moyens de paiement (PayPal, Stripe) sont actuellement disponibles pour la demande d'accès.GET /api/public/access-request/paypal/configFournit la configuration PayPal publique (actif, mode, devise) pour l'étape de paiement.POST /api/public/access-request/paypal/create-orderCrée une commande PayPal pour la formule choisie.POST /api/public/access-request/stripe/create-checkoutCrée une session de paiement Stripe pour la formule choisie.POST /api/public/activate-accountActive un compte utilisateur nouvellement créé et définit le premier mot de passe – déclenché via le lien de l'e-mail d'invitation.

Articles associés

← Formulaires publics