POST/api/public/access-request/paypal/capture-order
Schließt eine zuvor erstellte und vom Käufer im PayPal-Checkout freigegebene Bestellung ab (Capture). Den Betrag legt allein der Server fest.
Senden Sie die von `paypal/create-order` gelieferte Bestell-ID im Feld `order_id`, nachdem der Käufer die Zahlung bei PayPal freigegeben hat. Bei Erfolg ist die Zahlung abgeschlossen und der Zugangsantrag wird weiterbearbeitet. Fehlerfälle: 400 `ORDER_ID_REQUIRED` (Feld fehlt), 404 `UNKNOWN_ORDER` (keine bekannte Bestellung), 409 `CAPTURE_NOT_COMPLETED` (Zahlung noch nicht freigegeben – der Käufer muss den PayPal-Checkout abschließen) und 502 `PAYPAL_CAPTURE_FAILED` (Kommunikationsfehler mit PayPal). Rufen Sie den Endpunkt je Bestellung nur einmal auf.
Überblick
Aufruf: POST /api/public/access-request/paypal/capture-order. Der Endpunkt gehört zur Gruppe „Öffentliche Formulare“ der API von Zentor App. Er ist öffentlich erreichbar und benötigt keine Authentifizierung. Der Aufruf ist nicht idempotent: Jeder erfolgreiche Aufruf löst die Aktion erneut aus. Pflichtparameter: order_id (Body). Dokumentierte Fehlerfälle: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Die Beispielantwort unten zeigt den Aufbau einer erfolgreichen Antwort im JSON-Format.
Auth & Absicherung
Keine Authentifizierung erforderlich
Höchstens 10 Anfragen je 15 Minuten pro IP-Adresse.
Idempotent: Nein
Parameter
order_id(body, string, erforderlich)— Von `paypal/create-order` gelieferte PayPal-Bestell-IDBeispiel-Request
{"order_id":"<PAYPAL_ORDER_ID>"}Beispiel-Response
{"ok":false,"error":"UNKNOWN_ORDER","message":"Unbekannte Bestellung."}Fehlercodes
400 ORDER_ID_REQUIRED — Das Feld `order_id` fehlt.404 UNKNOWN_ORDER — `order_id` ist keine bekannte, zuvor erstellte Bestellung.409 CAPTURE_NOT_COMPLETED — Der Käufer hat die Zahlung noch nicht freigegeben.502 PAYPAL_CAPTURE_FAILED — Bei der Kommunikation mit PayPal ist ein Fehler aufgetreten.Geprüftes Verhalten
Ohne `order_id` liefert der Aufruf 400 `ORDER_ID_REQUIRED`, mit einer unbekannten Bestellung 404 `UNKNOWN_ORDER`. Der Erfolgsfall erfordert eine echte, vom Käufer freigegebene PayPal-Zahlung.
Öffentliche Formulare
POST /api/public/contactNimmt eine Anfrage aus dem Kontaktformular der Zentor-App-Website entgegen und leitet sie an das Zentor-Team weiter.POST /api/public/consultationNimmt eine Beratungsanfrage aus dem Formular der Zentor-App-Website entgegen.POST /api/public/access-requestReicht einen Zugangsantrag für ein Paket ein (Starter, Individuell oder 14-tägige Demo). Voraussetzung ist eine zuvor bestätigte E-Mail-Adresse.POST /api/public/access-request/email/start-verificationSendet einen sechsstelligen, 10 Minuten gültigen Bestätigungscode an die angegebene E-Mail-Adresse – der erste Schritt eines Zugangsantrags.POST /api/public/access-request/email/verifyPrüft den per E-Mail zugestellten Code und gibt ein Bestätigungstoken für den anschließenden Zugangsantrag aus.GET /api/public/access-request/payment-statusGibt an, welche Zahlungswege (PayPal, Stripe) für den Zugangsantrag aktuell verfügbar sind.GET /api/public/access-request/paypal/configLiefert die öffentliche PayPal-Konfiguration (aktiv, Modus, Währung) für den Bezahlschritt.POST /api/public/access-request/paypal/create-orderErstellt eine PayPal-Bestellung für das gewählte Paket.POST /api/public/access-request/stripe/create-checkoutErstellt eine Stripe-Checkout-Sitzung für das gewählte Paket.POST /api/public/activate-accountAktiviert ein neu angelegtes Benutzerkonto und setzt das erste Passwort – ausgelöst über den Link in der Einladungs-E-Mail.