POST/api/public/access-request/paypal/create-order
Skapar en PayPal-order för det valda paketet.
Skicka paketkoden i fältet `package` och valfritt sökandens `email`. Beloppet fastställs uteslutande på serversidan utifrån paketet. Vid framgång innehåller svarets `data`-objekt PayPal-order-ID:t `order_id` samt `amount_cents` och `currency`; med `order_id` godkänner köparen betalningen i PayPal-checkouten. Du slutför sedan betalningen med `POST /api/public/access-request/paypal/capture-order`. Ett ogiltigt paket resulterar i 400 `INVALID_PACKAGE`, en ogiltig e-postadress i 400 `INVALID_EMAIL`. Om PayPal för tillfället inte är tillgängligt svarar slutpunkten med 503 `PAYPAL_NOT_READY`. Slutpunkten är begränsad till 10 förfrågningar per 15 minuter per IP-adress. Varje lyckat anrop skapar en ny order; upprepa det inte automatiskt.
Översikt
Anrop: POST /api/public/access-request/paypal/create-order. Endpointen tillhör gruppen ”Offentliga formulär” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är inte idempotent: Varje lyckat anrop utlöser åtgärden på nytt. Obligatoriska parametrar: package (body). Dokumenterade felfall: 503 PAYPAL_NOT_READY. Exempelsvaret nedan visar strukturen för ett lyckat svar i JSON-format.
Autentisering & säkerhet
Ingen autentisering krävs
Idempotent: Nej
Parametrar
package(body, string, obligatorisk)— Paketkoden för det valda paketetExempel på request
{"package":"starter"}Exempel på response
{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal är för närvarande inte tillgänglig."}Felkoder
503 PAYPAL_NOT_READY — PayPal är för tillfället inte tillgängligt.Verifierat beteende
Utan en tillgänglig PayPal-anslutning returnerar anropet 503 `PAYPAL_NOT_READY`. Framgångsfallet kräver en verklig betalning via PayPal.
Offentliga formulär
POST /api/public/contactTar emot en förfrågan från kontaktformuläret på Zentor App-webbplatsen och vidarebefordrar den till Zentor-teamet.POST /api/public/consultationTar emot en rådgivningsförfrågan från formuläret på Zentor App-webbplatsen.POST /api/public/access-requestSkickar in en åtkomstbegäran för ett paket (Starter, Individuell eller 14-dagars demo). Det krävs en tidigare bekräftad e-postadress.POST /api/public/access-request/email/start-verificationSkickar en sexsiffrig bekräftelsekod, giltig i 10 minuter, till den angivna e-postadressen – det första steget i en åtkomstbegäran.POST /api/public/access-request/email/verifyKontrollerar koden som skickas via e-post och utfärdar en bekräftelsetoken för den efterföljande åtkomstbegäran.GET /api/public/access-request/payment-statusAnger vilka betalningsmetoder (PayPal, Stripe) som för tillfället är tillgängliga för åtkomstbegäran.GET /api/public/access-request/paypal/configReturnerar den offentliga PayPal-konfigurationen (aktiverad, läge, valuta) för betalningssteget.POST /api/public/access-request/paypal/capture-orderSlutför (capture) en tidigare skapad order som köparen har godkänt i PayPal-checkouten. Beloppet fastställs uteslutande av servern.POST /api/public/access-request/stripe/create-checkoutSkapar en Stripe-checkoutsession för det valda paketet.POST /api/public/activate-accountAktiverar ett nyskapat användarkonto och ställer in det första lösenordet – utlöst via länken i inbjudningsmejlet.