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

Tworzy zamówienie PayPal dla wybranego pakietu.

Wyślijcie kod pakietu w polu `package` oraz opcjonalnie `email` wnioskodawcy. Kwota jest ustalana wyłącznie po stronie serwera na podstawie pakietu. W przypadku powodzenia odpowiedź zawiera w obiekcie `data` identyfikator zamówienia PayPal `order_id` oraz `amount_cents` i `currency`; dzięki `order_id` kupujący zatwierdza płatność w kasie PayPal. Następnie finalizujecie płatność za pomocą `POST /api/public/access-request/paypal/capture-order`. Nieprawidłowy pakiet prowadzi do 400 `INVALID_PACKAGE`, nieprawidłowy adres e-mail do 400 `INVALID_EMAIL`. Jeśli PayPal jest aktualnie niedostępny, punkt końcowy odpowiada 503 `PAYPAL_NOT_READY`. Punkt końcowy jest ograniczony do 10 żądań na 15 minut na adres IP. Każde skuteczne wywołanie tworzy nowe zamówienie; nie powtarzajcie go automatycznie.

Przegląd

Wywołanie: POST /api/public/access-request/paypal/create-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: package (body). Udokumentowane przypadki błędów: 503 PAYPAL_NOT_READY. Poniższa przykładowa odpowiedź pokazuje strukturę udanej odpowiedzi w formacie JSON.

Uwierzytelnianie i zabezpieczenia

Uwierzytelnianie nie jest wymagane

Idempotentny: Nie

Parametry

package(body, string, wymagane)— Kod wybranego pakietu

Przykładowe żądanie

{"package":"starter"}

Przykładowa odpowiedź

{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal jest obecnie niedostępny."}

Kody błędów

503 PAYPAL_NOT_READY — PayPal jest aktualnie niedostępny.

Zweryfikowane zachowanie

Bez dostępnego połączenia z PayPal wywołanie zwraca 503 `PAYPAL_NOT_READY`. Przypadek sukcesu wymaga rzeczywistej płatności przez PayPal.

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/capture-orderFinalizuje (capture) wcześniej utworzone i zatwierdzone przez kupującego w kasie PayPal zamówienie. Kwotę ustala wyłącznie serwer.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.

Powiązane artykuły

← Formularze publiczne