POST/api/public/access-request/paypal/create-order
Erstellt eine PayPal-Bestellung für das gewählte Paket.
Senden Sie den Paket-Code im Feld `package` und optional die `email` des Antragstellers. Der Betrag wird ausschließlich serverseitig aus dem Paket ermittelt. Bei Erfolg enthält die Antwort im Objekt `data` die PayPal-Bestell-ID `order_id` sowie `amount_cents` und `currency`; mit der `order_id` gibt der Käufer die Zahlung im PayPal-Checkout frei. Anschließend schließen Sie die Zahlung mit `POST /api/public/access-request/paypal/capture-order` ab. Ein ungültiges Paket führt zu 400 `INVALID_PACKAGE`, eine ungültige E-Mail-Adresse zu 400 `INVALID_EMAIL`. Ist PayPal derzeit nicht verfügbar, antwortet der Endpunkt mit 503 `PAYPAL_NOT_READY`. Der Endpunkt ist auf 10 Anfragen je 15 Minuten pro IP-Adresse begrenzt. Jeder erfolgreiche Aufruf erstellt eine neue Bestellung; wiederholen Sie ihn nicht automatisch.
Überblick
Aufruf: POST /api/public/access-request/paypal/create-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: package (Body). Dokumentierte Fehlerfälle: 503 PAYPAL_NOT_READY. Die Beispielantwort unten zeigt den Aufbau einer erfolgreichen Antwort im JSON-Format.
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Nein
Parameter
package(body, string, erforderlich)— Paket-Code des gewählten PaketsBeispiel-Request
{"package":"starter"}Beispiel-Response
{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal ist derzeit nicht verfügbar."}Fehlercodes
503 PAYPAL_NOT_READY — PayPal ist derzeit nicht verfügbar.Geprüftes Verhalten
Ohne verfügbare PayPal-Anbindung liefert der Aufruf 503 `PAYPAL_NOT_READY`. Der Erfolgsfall erfordert eine echte Zahlung über PayPal.
Ö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/capture-orderSchließt eine zuvor erstellte und vom Käufer im PayPal-Checkout freigegebene Bestellung ab (Capture). Den Betrag legt allein der Server fest.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.