POST/api/public/access-request/paypal/capture-order
Igqibezela i-oda eladalwayo ngaphambili lakhululwa ngumthengi kwi-PayPal Checkout (Capture). Imali imiselwa yiseva kuphela.
Thumelani i-ID ye-oda efunyenweyo ku `paypal/create-order` kumhlathi `order_id`, emva kokuba umthengi ekhulule intlawulo kwiPayPal. Xa impumelelo, intlawulo igqitywa kwaye isicelo sokufikelela siqhutywa ngokwengeziweyo. Iimeko zeempazamo: 400 `ORDER_ID_REQUIRED` (umhlathi ungekho), 404 `UNKNOWN_ORDER` (akukho oda eliyaziwayo), 409 `CAPTURE_NOT_COMPLETED` (intlawulo ingakakhululwa – umthengi kufuneka agqibezele iPayPal Checkout) kunye no-502 `PAYPAL_CAPTURE_FAILED` (impazamo yonxibelelwano nePayPal). Nqwenela isiphelo kube kanye kuphela ngoda nganye.
Ushwankathelo
Ukubiza: POST /api/public/access-request/paypal/capture-order. Le endpoint yeyeqela elithi “Iifomu zikawonke-wonke” le-API ye-Zentor App. Ifikeleleka esidlangalaleni kwaye ayifuni kuqinisekiswa kwesazisi (authentication). Ukubiza ayisiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kwakhona. Iipharamitha ezinyanzelekileyo: order_id (body). Iimeko zeempazamo ezibhaliweyo: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. Impendulo engumzekelo engezantsi ibonisa ulwakhiwo lwempendulo ephumelelayo ngefomathi ye-JSON.
Ukuqinisekiswa nokhuseleko
Akukho kuqinisekiswa kufunekayo
Ubuninzi izicelo 10 kwimizuzu 15 kwidilesi ye-IP.
Idempotent: Hayi
Iiparamitha
order_id(body, string, kuyafuneka)— I-ID yeodolo ye-PayPal enikezwe ngu-`paypal/create-order`Umzekelo we-request
{"order_id":"<PAYPAL_ORDER_ID>"}Umzekelo we-response
{"ok":false,"error":"UNKNOWN_ORDER","message":"I-odolo engaziwayo."}Iikhowudi zeempazamo
400 ORDER_ID_REQUIRED — Intsimi `order_id` ayikho.404 UNKNOWN_ORDER — I-`order_id` ayilosodolo saziwayo, esenziwe ngaphambili.409 CAPTURE_NOT_COMPLETED — Umthengi akakavumeli intlawulo.502 PAYPAL_CAPTURE_FAILED — Kwenzeke impazamo kunxibelelwano ne-PayPal.Ukuziphatha okujongwe
Ngaphandle kwe-`order_id`, isicelo sinikeza 400 `ORDER_ID_REQUIRED`, ngeodolo engaziwa 404 `UNKNOWN_ORDER`. Imeko yempumelelo ifuna intlawulo yokwenene ye-PayPal evunyelwe ngumthengi.
Iifomu zikawonke-wonke
POST /api/public/contactYamkela isicelo esivela kwifomu lonxibelelwano lewebhusayithi ye-Zentor App kwaye isidlulisele kwiqela le-Zentor.POST /api/public/consultationYamkela isicelo sengcebiso esivela kwifomu lewebhusayithi ye-Zentor App.POST /api/public/access-requestNgenisa isicelo sokufikelela kwipakethi (Starter, Elungiselelweyo okanye idemo yeentsuku 14). Imfuno engaphambili yidilesi ye-imeyile eqinisekisiweyo ngaphambili.POST /api/public/access-request/email/start-verificationIthumela ikhowudi yamanani amathandathu, esebenza imizuzu 10, kwidilesi ye-imeyile enikezelweyo – inyathelo lokuqala lesicelo sokufikelela.POST /api/public/access-request/email/verifyIvavanya ikhowudi ehanjiswe nge-imeyile ize ikhuphe itoken yokuqinisekisa yesicelo sokufikelela esilandelayo.GET /api/public/access-request/payment-statusIbonisa ukuba zeziphi iindlela zokuhlawula (PayPal, Stripe) ezifumaneka ngoku kwisicelo sokufikelela.GET /api/public/access-request/paypal/configIbonelela ngokuqwalaselwa kwe-PayPal okuvulekileyo embuthweni (okusebenzayo, imowudi, uhlobo lwemali) kwinyathelo lokuhlawula.POST /api/public/access-request/paypal/create-orderIdala i-oda ye-PayPal yepakethi ekhethiweyo.POST /api/public/access-request/stripe/create-checkoutIdala iseshoni yokuhlawula ye-Stripe yepakethi elikhethiweyo.POST /api/public/activate-accountIvula i-akhawunti yomsebenzisi esandul' ukwenziwa kwaye isete iphasiwedi yokuqala – iqaliswa ngekhonkco kwi-imeyile yesimemo.