POST/api/public/access-request/paypal/create-order
منتخب پیکیج کے لیے PayPal آرڈر بناتا ہے۔
پیکیج کوڈ فیلڈ `package` میں اور اختیاری طور پر درخواست دہندہ کا `email` بھیجیں۔ رقم صرف سرور کی طرف سے پیکیج سے طے کی جاتی ہے۔ کامیابی پر جواب میں آبجیکٹ `data` میں PayPal آرڈر ID `order_id` کے علاوہ `amount_cents` اور `currency` شامل ہیں؛ `order_id` کے ذریعے خریدار PayPal چیک آؤٹ میں ادائیگی کی منظوری دیتا ہے۔ اس کے بعد آپ `POST /api/public/access-request/paypal/capture-order` کے ذریعے ادائیگی مکمل کرتے ہیں۔ غلط پیکیج 400 `INVALID_PACKAGE` کا باعث بنتا ہے، غلط ای میل ایڈریس 400 `INVALID_EMAIL` کا۔ اگر PayPal فی الحال دستیاب نہ ہو تو اینڈ پوائنٹ 503 `PAYPAL_NOT_READY` کے ساتھ جواب دیتا ہے۔ یہ اینڈ پوائنٹ فی IP ایڈریس ہر 15 منٹ میں 10 درخواستوں تک محدود ہے۔ ہر کامیاب کال نیا آرڈر بناتی ہے؛ اسے خودکار طور پر نہ دہرائیں۔
جائزہ
کال: POST /api/public/access-request/paypal/create-order۔ یہ اینڈپوائنٹ Zentor App کی API کے گروپ “عوامی فارمز” سے تعلق رکھتا ہے۔ یہ عوامی طور پر قابلِ رسائی ہے اور اس کے لیے کسی تصدیق (authentication) کی ضرورت نہیں۔ یہ کال idempotent نہیں ہے: ہر کامیاب کال عمل کو دوبارہ متحرک کرتی ہے۔ لازمی پیرامیٹرز: package (باڈی)۔ دستاویزی ایرر کیسز: 503 PAYPAL_NOT_READY۔ نیچے دیا گیا نمونہ جواب JSON فارمیٹ میں کامیاب جواب کی ساخت دکھاتا ہے۔
تصدیقِ شناخت اور تحفظ
تصدیقِ شناخت ضروری نہیں
Idempotent (دہرانے پر یکساں اثر): نہیں
پیرامیٹرز
package(body, string، ضروری)— منتخب پیکیج کا کوڈمثالی Request
{"package":"starter"}مثالی Response
{"ok":false,"error":"PAYPAL_NOT_READY","message":"PayPal فی الحال دستیاب نہیں ہے۔"}خرابی کے کوڈز
503 PAYPAL_NOT_READY — PayPal فی الحال دستیاب نہیں ہے۔تصدیق شدہ طرزِ عمل
دستیاب PayPal کنکشن کے بغیر، کال 503 `PAYPAL_NOT_READY` واپس دیتی ہے۔ کامیابی کی صورت کے لیے 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/capture-orderپہلے بنائے گئے اور خریدار کے PayPal چیک آؤٹ میں منظور شدہ آرڈر کو مکمل کرتا ہے (Capture)۔ رقم صرف سرور طے کرتا ہے۔POST /api/public/access-request/stripe/create-checkoutمنتخب پیکیج کے لیے Stripe چیک آؤٹ سیشن بناتا ہے۔POST /api/public/activate-accountنئے بنائے گئے اکاؤنٹ کو فعال کرتا ہے اور پہلا پاس ورڈ سیٹ کرتا ہے – دعوتی ای میل کے لنک کے ذریعے شروع ہوتا ہے۔