POST/api/public/access-request/paypal/capture-order
Finalizuje (capture) wcześniej utworzone i zatwierdzone przez kupującego w kasie PayPal zamówienie. Kwotę ustala wyłącznie serwer.
Po tym, jak kupujący zatwierdzi płatność w PayPal, wyślijcie identyfikator zamówienia zwrócony przez `paypal/create-order` w polu `order_id`. W przypadku powodzenia płatność jest zakończona, a wniosek o dostęp jest dalej przetwarzany. Przypadki błędów: 400 `ORDER_ID_REQUIRED` (brak pola), 404 `UNKNOWN_ORDER` (brak znanego zamówienia), 409 `CAPTURE_NOT_COMPLETED` (płatność jeszcze niezatwierdzona — kupujący musi dokończyć kasę PayPal) i 502 `PAYPAL_CAPTURE_FAILED` (błąd komunikacji z PayPal). Wywołajcie punkt końcowy tylko raz na zamówienie.
Przegląd
Wywołanie: POST /api/public/access-request/paypal/capture-order. Ten endpoint należy do grupy „Formularze publiczne” API Zentor App. Jest publicznie dostępny i nie wymaga uwierzytelniania. Wywołanie nie jest idempotentne: każde udane wywołanie ponownie uruchamia akcję. Parametry wymagane: order_id (body). Udokumentowane przypadki błędów: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Poniższa przykładowa odpowiedź pokazuje strukturę udanej odpowiedzi w formacie JSON.
Uwierzytelnianie i zabezpieczenia
Uwierzytelnianie nie jest wymagane
Maksymalnie 10 żądań na 15 minut na adres IP.
Idempotentny: Nie
Parametry
order_id(body, string, wymagane)— Identyfikator zamówienia PayPal zwrócony przez `paypal/create-order`Przykładowe żądanie
{"order_id":"<PAYPAL_ORDER_ID>"}Przykładowa odpowiedź
{"ok":false,"error":"UNKNOWN_ORDER","message":"Nieznane zamówienie."}Kody błędów
400 ORDER_ID_REQUIRED — Brakuje pola `order_id`.404 UNKNOWN_ORDER — `order_id` nie jest znanym, wcześniej utworzonym zamówieniem.409 CAPTURE_NOT_COMPLETED — Kupujący jeszcze nie zatwierdził płatności.502 PAYPAL_CAPTURE_FAILED — Wystąpił błąd komunikacji z PayPal.Zweryfikowane zachowanie
Bez `order_id` wywołanie zwraca 400 `ORDER_ID_REQUIRED`, przy nieznanym zamówieniu 404 `UNKNOWN_ORDER`. Przypadek sukcesu wymaga rzeczywistej płatności PayPal zatwierdzonej przez kupującego.
Formularze publiczne
POST /api/public/contactOdbiera zapytanie z formularza kontaktowego na stronie Zentor App i przekazuje je zespołowi Zentor.POST /api/public/consultationOdbiera zapytanie o doradztwo z formularza na stronie Zentor App.POST /api/public/access-requestSkłada wniosek o dostęp do pakietu (Starter, Indywidualna lub 14-dniowe Demo). Wymagany jest wcześniej potwierdzony adres e-mail.POST /api/public/access-request/email/start-verificationWysyła sześciocyfrowy kod potwierdzający, ważny 10 minut, na podany adres e-mail — pierwszy krok wniosku o dostęp.POST /api/public/access-request/email/verifySprawdza kod wysłany e-mailem i wydaje token potwierdzający na potrzeby kolejnego wniosku o dostęp.GET /api/public/access-request/payment-statusWskazuje, które metody płatności (PayPal, Stripe) są aktualnie dostępne dla wniosku o dostęp.GET /api/public/access-request/paypal/configZwraca publiczną konfigurację PayPal (aktywność, tryb, walutę) na potrzeby etapu płatności.POST /api/public/access-request/paypal/create-orderTworzy zamówienie PayPal dla wybranego pakietu.POST /api/public/access-request/stripe/create-checkoutTworzy sesję Stripe Checkout dla wybranego pakietu.POST /api/public/activate-accountAktywuje nowo utworzone konto użytkownika i ustawia pierwsze hasło — wywołane przez odnośnik w e-mailu z zaproszeniem.