لائیو ڈیمو

پیمنٹ گیٹ وے گائیڈ

سفری بکنگ ویب سائٹس کے لیے Razorpay API انضمام

Razorpay بھارت کے لیے ایک پیمنٹ گیٹ وے ہے جو روپے میں کارڈ، UPI، نیٹ بینکنگ اور والٹ قبول کرتا ہے۔ یہ گائیڈ بتاتی ہے کہ فلائٹ، ہوٹل یا ٹور بکنگ کے لیے Razorpay ادائیگی کیسے کام کرتی ہے، اور PHPTRAVELS میں اس کی اصل صورتحال کیا ہے: Razorpay آج تیار کنیکٹر نہیں ہے، لیکن اسے اس سورس کوڈ پر حسب ضرورت انضمام کے طور پر شامل کیا جا سکتا ہے جو آپ کی ملکیت ہے۔

  • کارڈ، UPI، نیٹ بینکنگ، والٹ
  • آرڈر، Checkout، کیپچر
  • دستخط اور ویب ہُک کی جانچ
  • مکمل اور جزوی ریفنڈ

ایک نظر میں Razorpay

Razorpay کیا ہے، اور PHPTRAVELS میں اس کی کیا حیثیت ہے

Razorpay ایک بھارتی پیمنٹ گیٹ وے ہے۔ بھارتی صارفین کو فروخت کرنے والا سفری کاروبار اسے وہ ادائیگی کے طریقے پیش کرنے کے لیے استعمال کرتا ہے جن کی وہ چیک آؤٹ پر توقع رکھتے ہیں: ڈیبٹ اور کریڈٹ کارڈ، UPI، نیٹ بینکنگ اور مقبول والٹ، جن کی وصولی اور سیٹلمنٹ تاجر کے اپنے Razorpay اکاؤنٹ میں بھارتی روپے میں ہوتی ہے۔

PHPTRAVELS ایک سیلف ہوسٹڈ سفری بکنگ پلیٹ فارم ہے جس میں مکمل سورس کوڈ شامل ہے۔ اس کے تیار پیمنٹ گیٹ وے ایک لائیو فہرست سے آتے ہیں جنہیں آپ اپنے تاجر اسناد سے آن کرتے ہیں۔ Razorpay آج اس فہرست میں نہیں ہے، اس لیے ایڈمن میں ابھی اس کا کوئی سوئچ نہیں ہے۔

اس کا مطلب یہ نہیں کہ آپ اسے استعمال نہیں کر سکتے۔ کوڈ آپ کی ملکیت ہے، اس لیے Razorpay کو کسٹم API انٹیگریشن کے طور پر شامل کیا جا سکتا ہے، اور بھارت کے لیے ایک تیار گیٹ وے پہلے سے موجود ہے: Cashfree۔ پیمنٹ گیٹ وے انٹیگریشن صفحہ وہ تمام گیٹ وے دکھاتا ہے جو آپ ابھی آن کر سکتے ہیں۔

آن لائن سفری ادائیگی کی مثالی تصویر: بکنگ چیک آؤٹ کارڈ ادائیگی کو پیمنٹ گیٹ وے تک پہنچاتا ہے اور نتیجہ بکنگ سسٹم میں واپس آتا ہے

Razorpay کا فیکٹ شیٹ

یہ کیا ہے
بھارت میں کاروباروں کے لیے ایک پیمنٹ گیٹ وے
ادائیگی کے طریقے
کارڈ، UPI، نیٹ بینکنگ اور والٹ
کرنسی
INR میں وصولی اور سیٹلمنٹ؛ رقم پیسے میں بھیجی جاتی ہے
API کیز
Key ID اور Key Secret، ٹیسٹ موڈ اور لائیو موڈ کے لیے الگ
PHPTRAVELS میں حیثیت
تیار کنیکٹر نہیں۔ شامل سورس کوڈ پر حسب ضرورت انضمام کے طور پر دستیاب
بھارت میں آج تیار
Cashfree، ایڈمن میں آپ کے اپنے Cashfree اکاؤنٹ سے آن ہوتا ہے
Cashfree سیٹ اپ گائیڈ

ادائیگی کا بہاؤ

سفری بکنگ کے لیے ایک Razorpay ادائیگی، قدم بہ قدم

Razorpay انضمام کام کو مسافر کے براؤزر اور آپ کے سرور میں تقسیم کرتا ہے۔ براؤزر Checkout دکھاتا ہے؛ سرور آرڈر بناتا ہے، نتیجہ جانچتا ہے اور طے کرتا ہے کہ بکنگ کب تصدیق شدہ ہو۔

  1. 01

    آپ کا سرور

    آرڈر بنائیں

    جب مسافر ادائیگی دباتا ہے تو آپ کا سرور Orders API کو پیسے میں رقم، کرنسی اور بکنگ ریفرنس پر مبنی receipt کے ساتھ کال کرتا ہے۔ Razorpay ایک order_id واپس کرتا ہے۔

  2. 02

    براؤزر

    Razorpay Checkout کھولیں

    بکنگ پیج آپ کی Key ID اور اسی order_id کے ساتھ Checkout کھولتا ہے، تاکہ مسافر ٹھیک وہی رقم ادا کرے جو آپ کے سرور نے طے کی ہے۔

  3. 03

    براؤزر

    مسافر ادائیگی کرتا ہے

    مسافر کارڈ، UPI، نیٹ بینکنگ یا والٹ چنتا ہے اور بینک کا مانگا ہوا ہر مرحلہ مکمل کرتا ہے۔ ادائیگی اب مجاز ہو چکی ہے۔

  4. 04

    براؤزر

    Checkout تین قدریں واپس کرتا ہے

    کامیابی پر Checkout razorpay_payment_id، razorpay_order_id اور razorpay_signature واپس دیتا ہے، اور پیج انہیں آپ کے سرور کو بھیج دیتا ہے۔

  5. 05

    آپ کا سرور

    دستخط کی تصدیق کریں

    آپ کا سرور order_id اور payment_id سے Key Secret کے ذریعے دستخط دوبارہ بناتا ہے۔ صرف مطابقت رکھنے والا دستخط ہی اصل ادائیگی مانا جاتا ہے۔

  6. 06

    آپ کا سرور

    ادائیگی کیپچر کریں

    خودکار کیپچر میں Razorpay خود کیپچر کرتا ہے۔ دستی کیپچر میں آپ کا سرور ایئرلائن، ہوٹل یا ٹور سپلائر کی تصدیق کے بعد کیپچر کرتا ہے، تاکہ ناکام بکنگ پر کسی سے رقم نہ کٹے۔

  7. 07

    آپ کا سرور

    بکنگ کی تصدیق کریں

    بکنگ ادا شدہ ہو جاتی ہے، ٹکٹ یا واؤچر جاری ہوتا ہے اور Razorpay کی payment_id بکنگ ریفرنس کے ساتھ محفوظ ہو جاتی ہے۔

  8. 08

    آپ کا سرورسرور سے سرور

    ویب ہُک وصول کریں

    Razorpay آپ کے ویب ہُک URL پر payment.captured جیسے ایونٹ بھی بھیجتا ہے۔ یہ اس مسافر کو سنبھالتا ہے جو پیج کے رپورٹ کرنے سے پہلے ٹیب بند کر دے۔

دستخط اور ویب ہُک

دو جانچیں جو Razorpay انضمام کو قابل اعتماد رکھتی ہیں

براؤزر یا انٹرنیٹ سے آنے والی ہر چیز جعلی ہو سکتی ہے۔ Razorpay انضمام کسی ادائیگی پر تب ہی بھروسا کرتا ہے جب وہ ایسے راز سے بنے دستخط کی جانچ کر لے جو آپ کے سرور سے باہر کبھی نہیں جاتا۔

verify-razorpay.php · مثالی
 1// 1. After Checkout: verify the payment signature 2$orderId   = $booking["razorpay_order_id"];  // from your own record 3$paymentId = $_POST["razorpay_payment_id"]; 4$signature = $_POST["razorpay_signature"]; 5$expected  = hash_hmac("sha256", $orderId . "|" . $paymentId, $keySecret); 6if (!hash_equals($expected, $signature)) { rejectPayment(); } 7markPaid($booking["ref"], $paymentId); 8 9// 2. Webhook: verify X-Razorpay-Signature over the raw body10$body    = file_get_contents("php://input");11$header  = $_SERVER["HTTP_X_RAZORPAY_SIGNATURE"] ?? "";12$expect  = hash_hmac("sha256", $body, $webhookSecret);13if (!hash_equals($expect, $header)) { http_response_code(400); exit; }14$event = json_decode($body, true);15if (alreadyHandled($event)) exit;          // repeat delivery16switch ($event["event"]) {17  case "payment.captured": confirmBooking($event); break;18  case "refund.processed": markRefunded($event);   break;19}

منطق دکھانے کے لیے مثالی سیوڈو کوڈ، براہ راست استعمال کی فائل نہیں۔ درست کالز کے لیے Razorpay کی اپنی دستاویزات اور SDK دیکھیں۔

  • ادائیگی کا دستخط

    order_id، ایک پائپ اور payment_id کا HMAC SHA256، آپ کی Key Secret بطور کلید کے ساتھ، razorpay_signature کے برابر ہونا چاہیے۔ موازنہ مستقل وقت والے فنکشن سے کریں۔

  • ویب ہُک کا دستخط

    ہر ویب ہُک میں X-Razorpay-Signature ہیڈر ہوتا ہے: خام ریکویسٹ باڈی کا HMAC SHA256، اس ویب ہُک سیکرٹ کے ساتھ جو آپ Razorpay ڈیش بورڈ میں طے کرتے ہیں۔

  • بار بار ڈیلیوری

    ویب ہُک ایک سے زیادہ بار یا الٹی ترتیب میں آ سکتے ہیں۔ ایونٹ اور ادائیگی کی IDs محفوظ کریں اور جس ایونٹ کو بکنگ پر پہلے لاگو کر چکے ہوں اسے نظرانداز کریں۔

  • راز سرور کی طرف رہتے ہیں

    صرف Key ID براؤزر کو جاتی ہے۔ Key Secret اور ویب ہُک سیکرٹ سرور کنفیگریشن میں رہتے ہیں، کبھی پیج سورس یا موبائل ایپ میں نہیں۔

ریفنڈ اور منسوخی

سفری ریفنڈ شاذ ہی پوری رقم کا ہوتا ہے

منسوخی فیس، نو شو کے قواعد اور جزوی طور پر منسوخ سفرنامے کی وجہ سے سفری ریفنڈ اکثر جزوی ہوتا ہے۔ Razorpay کی Refunds API دونوں کو سنبھالتی ہے، اور انضمام رقم کا فیصلہ آپ کے بکنگ قواعد سے کرتا ہے۔

  • مکمل ریفنڈ

    مفت منسوخی پوری کیپچر شدہ رقم اسی طریقے پر واپس کر دیتی ہے جس سے مسافر نے ادائیگی کی تھی۔

  • جزوی ریفنڈ

    منسوخی فیس کے بعد سرور صرف بقیہ رقم ریفنڈ کرتا ہے۔ رقم اصل آرڈر کی طرح پیسے میں بھیجی جاتی ہے۔

  • سفرنامے کا ایک حصہ

    ہوٹل کی ایک رات یا ایک مسافر منسوخ کریں اور وہی حصہ ریفنڈ کریں؛ کیپچر شدہ کل رقم تک مزید جزوی ریفنڈ ہو سکتے ہیں۔

  • refund.processed

    ریفنڈ ویب ہُک آپ کے سرور کو بتاتا ہے کہ ریفنڈ کب مکمل ہوا، تاکہ بکنگ اور مسافر کو درست حیثیت نظر آئے۔

  • بکنگ کے ساتھ محفوظ

    ہر ریفنڈ ID بکنگ ریفرنس اور اصل payment_id کے ساتھ آپ کی اکاؤنٹس ٹیم کے لیے رکھی جاتی ہے۔

  • مثال: فیس کے ساتھ منسوخی

    کیپچر شدہ
    ₹12,500.00 amount: 1250000
    منسوخی فیس
    ₹1,500.00 amount: 150000
    ریفنڈ کی رقم
    ₹11,000.00 amount: 1100000

    صرف مثال کے اعداد۔ Razorpay رقم کرنسی کی سب سے چھوٹی اکائی میں لیتا ہے، اس لیے 100 پیسے ایک روپیہ ہیں۔

Razorpay کیسے جوڑیں

ادائیگیاں لینے کے تین طریقے، Razorpay کے ساتھ یا بغیر

وہ راستہ چنیں جو آپ کی ٹیم اور لانچ کی تاریخ کے مطابق ہو۔ تینوں میں رقم آپ کے اپنے تاجر اکاؤنٹ میں رہتی ہے؛ PHPTRAVELS سیٹلمنٹ میں کبھی شامل نہیں ہوتا۔

  1. آپشن 1

    آپ کے ڈویلپرز شامل کرتے ہیں

    PHPTRAVELS مکمل سورس کوڈ کے ساتھ آتا ہے، اس لیے آپ کے اپنے ڈویلپرز موجودہ گیٹ ویز کے ساتھ Razorpay کو نئے گیٹ وے کے طور پر شامل کر سکتے ہیں: آرڈر بنانا، ادائیگی کے مرحلے پر Checkout، دستخط کی جانچ، کیپچر، ویب ہُک اور ریفنڈ۔

    • Razorpay ٹیسٹ موڈ کیز سے بنائیں اور آزمائیں
    • بکنگ ریفرنس کو آرڈر receipt کے طور پر دوبارہ استعمال کریں
    • ٹیسٹ بکنگ پاس ہونے پر لائیو کیز پر جائیں
    ڈویلپر API دستاویزات

  2. آپشن 2

    PHPTRAVELS بناتا ہے

    ہمارے ڈویلپرز آپ کے لیے Razorpay کنیکٹر کسٹم API انٹیگریشن کے طور پر بنا سکتے ہیں۔ آپ ضروریات بھیجتے ہیں، کام شروع ہونے سے پہلے لاگت اور وقت کا تخمینہ ملتا ہے، اور آخر میں آزمودہ سورس کوڈ حاصل ہوتا ہے۔

    • کام شروع ہونے سے پہلے کوٹیشن
    • Razorpay ٹیسٹ موڈ پر بنایا گیا
    • آپ کی ملکیت والے سورس کوڈ کے طور پر فراہم
    کوٹیشن مانگیں

  3. آپشن 3

    ابھی تیار گیٹ وے استعمال کریں

    اگر پہلے لانچ کرنا ہے تو پلیٹ فارم میں پہلے سے موجود گیٹ وے آن کریں۔ بھارت کے لیے وہ Cashfree ہے۔ آج کے تیار گیٹ ویز میں شامل ہیں:

    تمام پیمنٹ گیٹ ویز

تیار گیٹ ویز

پیمنٹ گیٹ ویز جو آپ آج آن کر سکتے ہیں

یہ فہرست PHPTRAVELS گیٹ وے ڈائریکٹری سے لائیو آتی ہے۔ ہر ایک ایڈمن میں آپ کے اپنے اکاؤنٹ اور کیز سے فعال ہوتا ہے۔

ان میں سے کسی کے پیچھے کی کالز سمجھنا چاہتے ہیں؟ پیمنٹ گیٹ وے API گائیڈ پڑھیں، Stripe ادائیگیاں اور PayPal ادائیگیاں گائیڈز کا موازنہ کریں، یا دیکھیں کہ B2B پورٹل پر ایجنٹ B2B ایجنٹ والیٹ سے ادائیگی کیسے کرتے ہیں۔

Razorpay کے سوالات

Razorpay اور PHPTRAVELS، جوابات کے ساتھ

سیلز سے بات کریں

تیار کنیکٹر کے طور پر نہیں۔ Razorpay آج PHPTRAVELS کی گیٹ وے فہرست میں نہیں ہے، اس لیے آپ اسے ایڈمن میں آن نہیں کر سکتے۔ چونکہ مکمل سورس کوڈ شامل ہے، اسے حسب ضرورت پیمنٹ گیٹ وے انضمام کے طور پر شامل کیا جا سکتا ہے، آپ کے ڈویلپرز یا ہمارے ڈویلپرز کے ذریعے۔

Cashfree PHPTRAVELS میں ایک تیار گیٹ وے ہے اور اس کی سیٹ اپ گائیڈ docs.phptravels.com/payments/cashfree پر ہے۔ آپ اسے ایڈمن میں اپنے Cashfree اکاؤنٹ سے آن کرتے ہیں۔ Stripe اور PayPal جیسے دیگر تیار گیٹ ویز پیمنٹ گیٹ ویز کے صفحے پر درج ہیں۔

Razorpay بھارتی روپے میں ادائیگیوں کے لیے کارڈ، UPI، نیٹ بینکنگ اور والٹ قبول کرتا ہے۔ چیک آؤٹ پر کون سے طریقے نظر آئیں گے، یہ آپ کے اپنے Razorpay اکاؤنٹ میں فعال چیزوں پر منحصر ہے۔

Razorpay رقم کرنسی کی سب سے چھوٹی اکائی میں لیتا ہے، اس لیے روپے میں بکنگ کا کل آرڈر بنانے سے پہلے 100 سے ضرب دیا جاتا ہے۔ ریفنڈ کی رقم بھی اسی طرح بھیجی جاتی ہے۔

Checkout ایک ادائیگی ID، آرڈر ID اور ایک دستخط واپس کرتا ہے۔ آپ کا سرور اپنی Key Secret سے آرڈر ID اور ادائیگی ID کا HMAC SHA256 بناتا ہے اور ادائیگی تبھی قبول کرتا ہے جب نتیجہ دستخط سے مل جائے۔

خودکار کیپچر آسان ہے۔ دستی کیپچر میں ایئرلائن، ہوٹل یا ٹور سپلائر کی تصدیق کے بعد ہی کیپچر کیا جاتا ہے، اس لیے ناکام بکنگ کو ریفنڈ کرنے کے بجائے ریلیز کیا جا سکتا ہے۔ انتخاب آپ کی مصنوعات اور سپلائرز پر منحصر ہے۔

جی ہاں۔ Razorpay کی Refunds API مکمل اور جزوی ریفنڈ دونوں سپورٹ کرتی ہے، اس لیے منسوخی فیس رکھ کر بقیہ رقم واپس کی جا سکتی ہے۔ refund.processed ویب ہُک آپ کے سرور کو بتاتا ہے کہ ریفنڈ مکمل ہو گیا۔

جی ہاں۔ تاجر اکاؤنٹ، اس کی Key ID اور Key Secret اور اس کی سیٹلمنٹ آپ کی ہے۔ PHPTRAVELS کبھی گیٹ وے اسناد فراہم نہیں کرتا اور آپ کی رقم کو کبھی نہیں سنبھالتا۔ ٹیسٹ موڈ کیز سے بنائیں اور لائیو جاتے وقت لائیو کیز پر جائیں۔

یہ آپ کی ضرورت کے دائرے پر منحصر ہے، جیسے چیک آؤٹ، دستی کیپچر، ریفنڈ اور ایجنٹ ادائیگیاں۔ PHPTRAVELS حسب ضرورت کام شروع ہونے سے پہلے کوٹیشن دیتا ہے۔ پلیٹ فارم خود ایک بار کا لائسنس ہے جو سے شروع ہوتا ہے۔

مزید دیکھیں

پلیٹ فارم کے بارے میں مزید