POST/api/public/access-request/paypal/create-order
Huunda agizo la PayPal kwa kifurushi kilichochaguliwa.
Tumeni msimbo wa kifurushi katika uga `package` na kwa hiari `email` ya mwombaji. Kiasi hubainishwa na seva pekee kulingana na kifurushi. Likifanikiwa, jibu lina ndani ya kitu `data` ID ya agizo la PayPal `order_id` pamoja na `amount_cents` na `currency`; kwa `order_id` mnunuzi anathibitisha malipo katika PayPal Checkout. Baadaye mnakamilisha malipo kwa `POST /api/public/access-request/paypal/capture-order`. Kifurushi kisicho sahihi husababisha 400 `INVALID_PACKAGE`, anwani ya barua pepe isiyo sahihi 400 `INVALID_EMAIL`. PayPal isipopatikana kwa sasa, sehemu ya mwisho hujibu na 503 `PAYPAL_NOT_READY`. Sehemu ya mwisho imewekewa kikomo cha maombi 10 kwa dakika 15 kwa kila anwani ya IP. Kila ombi lililofaulu huunda agizo jipya; msilirudie kiotomatiki.
Muhtasari
Mwito: POST /api/public/access-request/paypal/create-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: package (body). Hali za hitilafu zilizoandikwa: 503 PAYPAL_NOT_READY. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.
Uthibitishaji na ulinzi
Hakuna uthibitishaji unaohitajika
Idempotent: Hapana
Vigezo
package(body, string, inahitajika)— Msimbo wa kifurushi kilichochaguliwaMfano wa ombi (request)
{"package":"starter"}Mfano wa jibu (response)
{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal ist derzeit nicht verfügbar."}Misimbo ya hitilafu
503 PAYPAL_NOT_READY — PayPal haipatikani kwa sasa.Tabia iliyoangaliwa
Bila muunganisho wa PayPal unaopatikana, ombi hutoa 503 `PAYPAL_NOT_READY`. Hali ya ufanisi inahitaji malipo halisi kupitia PayPal.
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/capture-orderHukamilisha agizo lililoundwa awali na kuthibitishwa na mnunuzi katika PayPal Checkout (Capture). Kiasi hubainishwa na seva pekee.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.