POST/api/public/access-request/paypal/capture-order
Pë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.
Dërgoni ID-në e porosisë, të marrë nga `paypal/create-order`, në fushën `order_id`, pasi blerësi ka miratuar pagesën te PayPal. Në rast suksesi, pagesa është e përfunduar dhe kërkesa e aksesit përpunohet më tej. Rastet e gabimeve: 400 `ORDER_ID_REQUIRED` (fusha mungon), 404 `UNKNOWN_ORDER` (porosi e panjohur), 409 `CAPTURE_NOT_COMPLETED` (pagesa nuk është miratuar ende – blerësi duhet të përfundojë checkout-in e PayPal) dhe 502 `PAYPAL_CAPTURE_FAILED` (gabim komunikimi me PayPal). Thërrisni endpoint-in vetëm një herë për porosi.
Përmbledhje
Thirrja: POST /api/public/access-request/paypal/capture-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: order_id (body). Rastet e dokumentuara të gabimeve: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Përgjigjja shembull më poshtë tregon strukturën e një përgjigjeje të suksesshme në formatin JSON.
Autentifikimi dhe siguria
Nuk kërkohet autentifikim
Maksimumi 10 kërkesa për 15 minuta për IP.
Idempotent: Jo
Parametrat
order_id(body, string, i detyrueshëm)— ID-ja e porosisë PayPal, e marrë nga `paypal/create-order`Shembull request-i
{"order_id":"<PAYPAL_ORDER_ID>"}Shembull response-i
{"ok":false,"error":"UNKNOWN_ORDER","message":"Porosi e panjohur."}Kodet e gabimeve
400 ORDER_ID_REQUIRED — Fusha `order_id` mungon.404 UNKNOWN_ORDER — `order_id` nuk është një porosi e njohur, e krijuar më parë.409 CAPTURE_NOT_COMPLETED — Blerësi nuk e ka miratuar ende pagesën.502 PAYPAL_CAPTURE_FAILED — Ndodhi një gabim në komunikimin me PayPal.Sjellja e verifikuar
Pa `order_id`, thirrja kthen 400 `ORDER_ID_REQUIRED`, me një porosi të panjohur 404 `UNKNOWN_ORDER`. Rasti i suksesit kërkon një pagesë reale PayPal, të miratuar nga blerësi.
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/create-orderKrijon një porosi PayPal për paketën e zgjedhur.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.