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

پہلے بنائے گئے اور خریدار کے PayPal چیک آؤٹ میں منظور شدہ آرڈر کو مکمل کرتا ہے (Capture)۔ رقم صرف سرور طے کرتا ہے۔

خریدار کے PayPal میں ادائیگی منظور کرنے کے بعد `paypal/create-order` کی طرف سے دی گئی آرڈر ID کو فیلڈ `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 آرڈر ID

مثالی Request

{"order_id":"<PAYPAL_ORDER_ID>"}

مثالی Response

{"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نئے بنائے گئے اکاؤنٹ کو فعال کرتا ہے اور پہلا پاس ورڈ سیٹ کرتا ہے – دعوتی ای میل کے لنک کے ذریعے شروع ہوتا ہے۔

متعلقہ مضامین

← عوامی فارمز