POST/api/public/access-request/paypal/create-order
Krijon një porosi PayPal për paketën e zgjedhur.
Dërgoni kodin e paketës në fushën `package` dhe opsionale `email`-in e kërkuesit. Shuma përcaktohet ekskluzivisht në anën e serverit nga paketa. Në rast suksesi, përgjigja përmban në objektin `data` ID-në e porosisë PayPal `order_id`, si dhe `amount_cents` dhe `currency`; me `order_id` blerësi miraton pagesën në checkout-in e PayPal. Më pas e përfundoni pagesën me `POST /api/public/access-request/paypal/capture-order`. Një paketë e pavlefshme çon në 400 `INVALID_PACKAGE`, një adresë e-maili e pavlefshme në 400 `INVALID_EMAIL`. Nëse PayPal nuk është i disponueshëm aktualisht, endpoint-i përgjigjet me 503 `PAYPAL_NOT_READY`. Endpoint-i është i kufizuar në 10 kërkesa për 15 minuta për IP. Çdo thirrje e suksesshme krijon një porosi të re; mos e përsërisni automatikisht.
Përmbledhje
Thirrja: POST /api/public/access-request/paypal/create-order. Ky endpoint i përket grupit “Formularët publikë” të API-së së Zentor App. Është i aksesueshëm publikisht dhe nuk kërkon autentifikim. Thirrja nuk është idempotente: çdo thirrje e suksesshme e shkakton veprimin përsëri. Parametrat e detyrueshëm: package (body). Rastet e dokumentuara të gabimeve: 503 PAYPAL_NOT_READY. Përgjigjja shembull më poshtë tregon strukturën e një përgjigjeje të suksesshme në formatin JSON.
Autentifikimi dhe siguria
Nuk kërkohet autentifikim
Idempotent: Jo
Parametrat
package(body, string, i detyrueshëm)— Kodi i paketës së zgjedhurShembull request-i
{"package":"starter"}Shembull response-i
{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal aktualisht nuk është i disponueshëm."}Kodet e gabimeve
503 PAYPAL_NOT_READY — PayPal nuk është i disponueshëm aktualisht.Sjellja e verifikuar
Pa lidhjen e disponueshme të PayPal-it, thirrja kthen 503 `PAYPAL_NOT_READY`. Rasti i suksesit kërkon një pagesë reale përmes PayPal-it.
Formularët publikë
POST /api/public/contactPranon një kërkesë nga formulari i kontaktit në faqen e internetit të Zentor App dhe ia përcjell ekipit të Zentor.POST /api/public/consultationPranon një kërkesë për konsulencë nga formulari i faqes së internetit të Zentor App.POST /api/public/access-requestDërgon një kërkesë aksesi për një paketë (Starter, Individuale ose demo 14-ditore). Parakusht është një adresë e-maili e konfirmuar paraprakisht.POST /api/public/access-request/email/start-verificationDërgon një kod konfirmimi me gjashtë shifra, të vlefshëm për 10 minuta, në adresën e dhënë të e-mailit – hapi i parë i një kërkese aksesi.POST /api/public/access-request/email/verifyKontrollon kodin e dërguar me e-mail dhe lëshon një token konfirmimi për kërkesën e aksesit që pason.GET /api/public/access-request/payment-statusTregon cilat mënyra pagese (PayPal, Stripe) janë aktualisht në dispozicion për kërkesën e aksesit.GET /api/public/access-request/paypal/configKthen konfigurimin publik të PayPal-it (aktiv, mënyra, monedha) për hapin e pagesës.POST /api/public/access-request/paypal/capture-orderPërfundon (capture) një porosi të krijuar më parë, që blerësi e ka miratuar në checkout-in e PayPal. Shumën e përcakton vetëm serveri.POST /api/public/access-request/stripe/create-checkoutKrijon një sesion checkout-i të Stripe-it për paketën e zgjedhur.POST /api/public/activate-accountAktivizon një llogari përdoruesi të krijuar rishtazi dhe vendos fjalëkalimin e parë – nisur përmes lidhjes në e-mailin e ftesës.