فوری آغاز: 5 منٹ میں اپنے ادائیگی کے انضمام کی جانچ کریں

اپنے انضمام کو 5 منٹ میں آزمائیں

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

مرحلہ 1: سینڈ باکس اسناد حاصل کریں

/sandbox کھولیں۔ App ID، API Key (دستخط کے لیے)، اور Query Key (آرڈر کی تلاش کے لیے) کاپی کریں۔

مرحلہ 2: ایک ٹیسٹ آرڈر بنائیں

پلے گراؤنڈ فارم استعمال کریں یا /api/createorder پر دستخط شدہ POST بھیجیں:

curl -X POST "https://your-domain.com/api/createorder" \
  -H "Content-Type: application/json" \
  -d '{
    "appid": "YOUR_SANDBOX_APPID",
    "action": "createorder",
    "clientip": "127.0.0.1",
    "amount": "9.99",
    "currency": "USD",
    "paymentMethod": "alipay",
    "description": "Test order",
    "notify_url": "https://your-domain.com/api/sandbox/webhook-receiver",
    "sign_type": "MD5",
    "sign": "CALCULATED_MD5_SIGN"
  }'

پلے گراؤنڈ آپ کے لیے MD5 دستخط کا حساب لگاتا ہے۔ الگورتھم کے لیے API دستاویزات — دستخط دیکھیں۔

مرحلہ 3: ادائیگی کا نقلی عمل

create-order کے جواب سے redirectUrl کھولیں (یا Playground میں Simulate pay استعمال کریں)۔ Simulate Success پر کلک کریں۔ گیٹ وے آپ کے notify_url پر ایک ویب ہک قطار میں لگا دیتا ہے۔

مرحلہ 4: ویب ہُک دستخط کی تصدیق کریں

کال بیکس GET کے طور پر بھیجے جاتے ہیں جس میں کوئری پیرامیٹرز شامل ہوتے ہیں جن میں sign اور sign_type=MD5 شامل ہیں۔ اپنی API Key کے ساتھ، آرڈر بنانے والے الگورتھم کا استعمال کرتے ہوئے تصدیق کریں۔

// Node.js مثال (تصوراتی)
const crypto = require('crypto');
function verifyCallback(params, apiKey) {
  const copy = { ...params };
  delete copy.sign;
  delete copy.sign_type;
  const keys = Object.keys(copy).filter(k => copy[k] != null).sort();
  const str = keys.map(k => k + '=' + copy[k]).join('&') + apiKey;
  const expected = crypto.createHash('md5').update(str).digest('hex');
  return expected === params.sign;
}

آپ کے سرور کو سادہ متن success (کیس-غیر حساس) کے ساتھ جواب دینا چاہیے۔

مرحلہ 5: آرڈر کی حیثیت استفسار کریں

GET /api/order?action=order&appid=APPID&key=QUERY_KEY&paymentId=ORDER_ID

یا عوامی اینڈ پوائنٹ سے استفسار کریں: GET /api/order/status/:orderId

پیداوار میں جانا

• ایک مرچنٹ اکاؤنٹ رجسٹر کریں اور اپنا پیداواری appid، apikey، اور key استعمال کریں۔
• اکاؤنٹ کی ترتیبات میں یا فی آرڈر اپنا اصلی notify_url سیٹ کریں۔
• API Key کو کلائنٹ سائیڈ کوڈ میں کبھی ظاہر نہ کریں۔
• ویب ہک دستخطوں کی ہمیشہ سرور سائیڈ پر تصدیق کریں۔

مکمل حوالہ: API دستاویزات · لائیو ٹیسٹنگ: سینڈ باکس پلے گراؤنڈ