দ্রুত শুরু: ৫ মিনিটে আপনার পেমেন্ট ইন্টিগ্রেশন পরীক্ষা করুন

Team 2 min read ৪৩ views

৫ মিনিটে আপনার ইন্টিগ্রেশন পরীক্ষা করুন

আমাদের পাবলিক স্যান্ডবক্স API প্লেগ্রাউন্ড শেয়ার্ড টেস্ট ক্রেডেনশিয়াল সহ ব্যবহার করুন। কোনো প্রকৃত অর্থ চার্জ করা হয় না — অর্ডার কখনো লাইভ পেমেন্ট প্রদানকারীদের কাছে পৌঁছায় না।

ধাপ ১: স্যান্ডবক্স ক্রেডেনশিয়াল সংগ্রহ করুন

/sandbox খুলুন। অ্যাপ আইডি, এপিআই কী (স্বাক্ষরের জন্য) এবং কোয়েরি কী (অর্ডার দেখার জন্য) কপি করুন।

ধাপ ২: একটি টেস্ট অর্ডার তৈরি করুন

প্লেগ্রাউন্ড ফর্ম ব্যবহার করুন অথবা /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 ডকুমেন্টেশন — স্বাক্ষর দেখুন।

ধাপ ৩: পেমেন্ট সিমুলেট করুন

redirectUrl থেকে অর্ডার তৈরির প্রতিক্রিয়া খুলুন (অথবা প্লেগ্রাউন্ডে সিমুলেট পে ব্যবহার করুন)। সিমুলেট সাকসেস-এ ক্লিক করুন। গেটওয়ে আপনার notify_url-এ একটি ওয়েবহুক সারিবদ্ধ করে।

ধাপ ৪: ওয়েবহুক স্বাক্ষর যাচাই করুন

কলব্যাকগুলি GET হিসেবে পাঠানো হয়, যেখানে কুয়েরি প্যারামিটার হিসেবে sign এবং sign_type=MD5 অন্তর্ভুক্ত থাকে। আপনার API কী ব্যবহার করে অর্ডার তৈরির মতো একই অ্যালগরিদম দিয়ে যাচাই করুন।

// 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 (কেস-ইনসেন্সিটিভ) দিয়ে সাড়া দিতে হবে।

ধাপ ৫: অর্ডারের অবস্থা জানুন

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

অথবা পাবলিক এন্ডপয়েন্টটি পোল করুন: GET /api/order/status/:orderId

উৎপাদনে যাচ্ছে

সম্পূর্ণ রেফারেন্স: এপিআই ডকুমেন্টেশন · লাইভ টেস্টিং: স্যান্ডবক্স প্লেগ্রাউন্ড

ট্যাগ: api, sandbox, integration, webhook

← সমস্ত পোস্ট