POST/api/public/access-request/paypal/capture-order
முன்பு உருவாக்கப்பட்டு வாங்குபவரால் PayPal செக்அவுட்டில் ஒப்புக்கொள்ளப்பட்ட ஆர்டரை முடிக்கிறது (Capture). தொகையை சர்வர் மட்டுமே தீர்மானிக்கிறது.
வாங்குபவர் PayPal-இல் கட்டணத்தை ஒப்புக்கொண்ட பிறகு `paypal/create-order` வழங்கிய ஆர்டர் ஐடியை `order_id` புலத்தில் அனுப்பவும். வெற்றியடைந்தால் கட்டணம் முடிந்து அணுகல் கோரிக்கை மேலும் செயலாக்கப்படும். பிழை நிகழ்வுகள்: 400 `ORDER_ID_REQUIRED` (புலம் இல்லை), 404 `UNKNOWN_ORDER` (அறியப்பட்ட ஆர்டர் இல்லை), 409 `CAPTURE_NOT_COMPLETED` (கட்டணம் இன்னும் ஒப்புக்கொள்ளப்படவில்லை – வாங்குபவர் PayPal செக்அவுட்டை முடிக்க வேண்டும்) மற்றும் 502 `PAYPAL_CAPTURE_FAILED` (PayPal உடனான தொடர்பு பிழை). ஒரு ஆர்டருக்கு முடிவுப்புள்ளியை ஒரே ஒரு முறை மட்டும் அழைக்கவும்.
கண்ணோட்டம்
அழைப்பு: POST /api/public/access-request/paypal/capture-order. இந்த எண்ட்பாயிண்ட் Zentor App API-யின் “பொது படிவங்கள்” குழுவைச் சேர்ந்தது. இது பொதுவில் அணுகக்கூடியது; அங்கீகாரம் (authentication) தேவையில்லை. இந்த அழைப்பு idempotent அல்ல: ஒவ்வொரு வெற்றிகரமான அழைப்பும் செயலை மீண்டும் தூண்டும். கட்டாய அளவுருக்கள்: order_id (பாடி). ஆவணப்படுத்தப்பட்ட பிழை நிலைகள்: 400 ORDER_ID_REQUIRED, 404 UNKNOWN_ORDER, 409 CAPTURE_NOT_COMPLETED, 502 PAYPAL_CAPTURE_FAILED. கீழே உள்ள மாதிரி பதில், JSON வடிவில் வெற்றிகரமான பதிலின் கட்டமைப்பைக் காட்டுகிறது.
அங்கீகாரம் & பாதுகாப்பு
அங்கீகாரம் தேவையில்லை
ஒரு IP முகவரிக்கு 15 நிமிடங்களுக்கு அதிகபட்சம் 10 கோரிக்கைகள்.
Idempotent (மீண்டும் செய்தாலும் அதே விளைவு): இல்லை
அளவுருக்கள்
order_id(body, string, கட்டாயம்)— `paypal/create-order` வழங்கிய PayPal ஆர்டர் ஐடிஎடுத்துக்காட்டுக் கோரிக்கை
{"order_id":"<PAYPAL_ORDER_ID>"}எடுத்துக்காட்டுப் பதில்
{"ok":false,"error":"UNKNOWN_ORDER","message":"அறியப்படாத ஆர்டர்."}பிழைக் குறியீடுகள்
400 ORDER_ID_REQUIRED — `order_id` புலம் இல்லை.404 UNKNOWN_ORDER — `order_id` முன்பு உருவாக்கப்பட்ட அறியப்பட்ட ஆர்டர் அல்ல.409 CAPTURE_NOT_COMPLETED — வாங்குபவர் இன்னும் கட்டணத்தை ஒப்புக்கொள்ளவில்லை.502 PAYPAL_CAPTURE_FAILED — PayPal உடனான தொடர்பில் பிழை ஏற்பட்டது.சரிபார்க்கப்பட்ட நடத்தை
`order_id` இல்லாமல் அழைப்பு 400 `ORDER_ID_REQUIRED`-ஐத் திருப்பி அளிக்கிறது, அறியப்படாத ஆர்டருடன் 404 `UNKNOWN_ORDER`. வெற்றி நிலைக்கு வாங்குபவர் ஒப்புக்கொண்ட உண்மையான PayPal கட்டணம் தேவை.
பொது படிவங்கள்
POST /api/public/contactZentor App இணையதளத்தின் தொடர்பு படிவத்திலிருந்து ஒரு கோரிக்கையைப் பெற்று அதை Zentor குழுவிற்கு அனுப்புகிறது.POST /api/public/consultationZentor App இணையதள படிவத்திலிருந்து ஒரு ஆலோசனைக் கோரிக்கையைப் பெறுகிறது.POST /api/public/access-requestஒரு தொகுப்புக்கு (Starter, தனிப்பயனாக்கப்பட்ட அல்லது 14 நாள் டெமோ) அணுகல் கோரிக்கையைச் சமர்ப்பிக்கிறது. இதற்கு முன்பே உறுதிப்படுத்தப்பட்ட மின்னஞ்சல் முகவரி தேவை.POST /api/public/access-request/email/start-verificationகொடுக்கப்பட்ட மின்னஞ்சல் முகவரிக்கு ஆறு இலக்க, 10 நிமிடங்களுக்கு செல்லுபடியாகும் உறுதிப்படுத்தல் குறியீட்டை அனுப்புகிறது – அணுகல் கோரிக்கையின் முதல் படி.POST /api/public/access-request/email/verifyமின்னஞ்சல் மூலம் அனுப்பப்பட்ட குறியீட்டைச் சரிபார்த்து, பின்வரும் அணுகல் கோரிக்கைக்கான உறுதிப்படுத்தல் டோக்கனை வெளியிடுகிறது.GET /api/public/access-request/payment-statusஅணுகல் கோரிக்கைக்கு தற்போது எந்தக் கட்டண முறைகள் (PayPal, Stripe) கிடைக்கின்றன என்பதைக் குறிக்கிறது.GET /api/public/access-request/paypal/configகட்டணச் செயல்முறைக்கான பொது PayPal உள்ளமைவை (இயக்கப்பட்டது, முறை, நாணயம்) வழங்குகிறது.POST /api/public/access-request/paypal/create-orderதேர்ந்தெடுக்கப்பட்ட தொகுப்புக்கான PayPal ஆர்டரை உருவாக்குகிறது.POST /api/public/access-request/stripe/create-checkoutதேர்ந்தெடுக்கப்பட்ட தொகுப்புக்கான Stripe செக்அவுட் அமர்வை உருவாக்குகிறது.POST /api/public/activate-accountபுதிதாக உருவாக்கப்பட்ட கணக்கைச் செயல்படுத்தி முதல் கடவுச்சொல்லை அமைக்கிறது – அழைப்பு மின்னஞ்சலில் உள்ள இணைப்பு மூலம் தொடங்கப்படுகிறது.