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

Hukamilisha agizo lililoundwa awali na kuthibitishwa na mnunuzi katika PayPal Checkout (Capture). Kiasi hubainishwa na seva pekee.

Tumeni ID ya agizo iliyotolewa na `paypal/create-order` katika uga `order_id`, baada ya mnunuzi kuthibitisha malipo kwa PayPal. Likifanikiwa, malipo yamekamilika na ombi la ufikiaji linashughulikiwa zaidi. Hali za makosa: 400 `ORDER_ID_REQUIRED` (uga haupo), 404 `UNKNOWN_ORDER` (hakuna agizo linalofahamika), 409 `CAPTURE_NOT_COMPLETED` (malipo hayajathibitishwa bado – mnunuzi anapaswa kukamilisha PayPal Checkout) na 502 `PAYPAL_CAPTURE_FAILED` (hitilafu ya mawasiliano na PayPal). Pigieni sehemu ya mwisho mara moja pekee kwa kila agizo.

Muhtasari

Mwito: POST /api/public/access-request/paypal/capture-order. Endpoint hii ni sehemu ya kundi la “Fomu za umma” la API ya Zentor App. Inafikika hadharani na haihitaji uthibitishaji. Mwito huu si idempotent: kila mwito uliofanikiwa huanzisha kitendo upya. Vigezo vya lazima: order_id (body). Hali za hitilafu zilizoandikwa: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.

Uthibitishaji na ulinzi

Hakuna uthibitishaji unaohitajika

Kiwango cha juu maombi 10 kwa dakika 15 kwa anwani ya IP.

Idempotent: Hapana

Vigezo

order_id(body, string, inahitajika)— Kitambulisho cha agizo la PayPal kilichotolewa na `paypal/create-order`

Mfano wa ombi (request)

{"order_id":"<PAYPAL_ORDER_ID>"}

Mfano wa jibu (response)

{"ok":false,"error":"UNKNOWN_ORDER","message":"Agizo lisilojulikana."}

Misimbo ya hitilafu

400 ORDER_ID_REQUIRED — Sehemu `order_id` inakosekana.
404 UNKNOWN_ORDER — `order_id` si agizo linalofahamika, lililoundwa awali.
409 CAPTURE_NOT_COMPLETED — Mnunuzi hajaidhinisha malipo bado.
502 PAYPAL_CAPTURE_FAILED — Hitilafu imetokea wakati wa mawasiliano na PayPal.

Tabia iliyoangaliwa

Bila `order_id`, ombi hutoa 400 `ORDER_ID_REQUIRED`, na agizo lisilojulikana 404 `UNKNOWN_ORDER`. Hali ya ufanisi inahitaji malipo halisi ya PayPal yaliyoidhinishwa na mnunuzi.

Fomu za umma

POST /api/public/contactHupokea ombi kutoka kwenye fomu ya mawasiliano ya tovuti ya Zentor App na kulipeleka kwa timu ya Zentor.POST /api/public/consultationHupokea ombi la ushauri kutoka kwenye fomu ya tovuti ya Zentor App.POST /api/public/access-requestHutuma ombi la ufikiaji kwa kifurushi (Starter, Individuell au demo ya siku 14). Sharti ni anwani ya barua pepe iliyothibitishwa awali.POST /api/public/access-request/email/start-verificationHutuma msimbo wa nambari sita, unaofanya kazi dakika 10, kwenye anwani ya barua pepe iliyotolewa – hatua ya kwanza ya ombi la ufikiaji.POST /api/public/access-request/email/verifyHukagua msimbo uliotolewa kwa barua pepe na hutoa tokeni ya uthibitisho kwa ombi la ufikiaji linalofuata.GET /api/public/access-request/payment-statusHuonyesha njia za malipo zinazopatikana sasa (PayPal, Stripe) kwa ombi la ufikiaji.GET /api/public/access-request/paypal/configHutoa usanidi wa umma wa PayPal (unaotumika, hali, sarafu) kwa hatua ya malipo.POST /api/public/access-request/paypal/create-orderHuunda agizo la PayPal kwa kifurushi kilichochaguliwa.POST /api/public/access-request/stripe/create-checkoutHuunda kipindi cha malipo cha Stripe kwa kifurushi kilichochaguliwa.POST /api/public/activate-accountHuwezesha akaunti ya mtumiaji iliyoundwa upya na kuweka nenosiri la kwanza – linaloanzishwa kupitia kiungo kwenye barua pepe ya mwaliko.

Makala zinazohusiana

← Fomu za umma