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.

Artikuj të lidhur

← Formularët publikë