অর্ডার এন্ডপয়েন্ট

প্রতিটি অর্ডার তৈরি হয় আপনার নিজের বানানো একটি UUID দিয়ে। এই UUID-ই idempotency key: একই UUID আবার পাঠালে দ্বিতীয়বার চার্জ হয় না, আগের অর্ডারটিই ফেরত আসে। এরপর স্ট্যাটাস দেখতে পারবেন প্রতিটি অর্ডার আলাদা করে, সর্বোচ্চ 50টির ব্যাচে, অথবা পেজিনেটেড তালিকায়।

POST

/orders/create

অর্ডার তৈরি করুন

নতুন অর্ডার দিন। idempotency-র জন্য order_id হিসেবে একটি ইউনিক UUID দিতেই হবে। ওয়ালেট থেকে সঙ্গে সঙ্গে দাম কেটে নেওয়া হবে।

রেট লিমিটপ্রতি অ্যাকাউন্টে 60 সেকেন্ডে 5000 রিকোয়েস্ট

নোট: order_id-ই আপনার idempotency key। একই UUID দিয়ে আবার চেষ্টা করলে ডুপ্লিকেট অর্ডার তৈরি হবে না, আগের অর্ডারটিই ফেরত আসবে।

রিকোয়েস্ট বডি

নামধরনআবশ্যকবিবরণউদাহরণ
order_idstring (UUID)হ্যাঁএই অর্ডারের জন্য একটি ইউনিক UUID (যেকোনো ফরম্যাট চলবে: v1, v4, v7 ইত্যাদি)। এটি idempotency key হিসেবে ব্যবহার হয়।01912345-6789-7abc-8def-0123456789ab
sub_category_idnumberহ্যাঁপ্রোডাক্টের সাবক্যাটাগরি ID।999
quantitynumberহ্যাঁকত ইউনিট অর্ডার করবেন (ধনাত্মক পূর্ণসংখ্যা)।1
requirementsobjectহ্যাঁপ্লেয়ারের ডেলিভারি তথ্য। ক্যাটাগরির রিকোয়ারমেন্ট এন্ডপয়েন্ট যে ফিল্ডগুলো দেয়, তার সবগুলোই দিন।{"player_id": "123456789", "server": "Asia"}
expected_unit_pricestringনাদামের সুরক্ষা। বর্তমান দাম এই মানের চেয়ে বেশি হলে অর্ডার নেওয়া হবে না।0.950000
রিকোয়েস্ট
curl -s -X POST "https://shop2topup.com/api/endpoints/v1/orders/create" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "order_id": "01912345-6789-7abc-8def-0123456789ab",
  "sub_category_id": 999,
  "quantity": 1,
  "requirements": {
    "player_id": "123456789",
    "server": "Asia"
  },
  "expected_unit_price": 0.95
}'
রেসপন্সের উদাহরণ
{
  "success": true,
  "order": {
    "order_id": "01912345-6789-7abc-8def-0123456789ab",
    "status": "pending",
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "subcategory_name": "FF 100 Diamonds",
    "quantity": 1,
    "charged_amount": "0.950000",
    "currency": "USD",
    "created_at": "2024-06-15T12:00:00Z"
  }
}
GET

/orders/:orderId

অর্ডারের স্ট্যাটাস দেখুন

নির্দিষ্ট একটি অর্ডারের বর্তমান স্ট্যাটাস ও বিস্তারিত তথ্য দেখুন।

রেট লিমিটপ্রতি অ্যাকাউন্ট ও order_id জোড়ায় 60 সেকেন্ডে 3 রিকোয়েস্ট

নোট: অর্ডারের স্ট্যাটাস হতে পারে pending (পেন্ডিং), completed (সম্পন্ন), refunded (রিফান্ড হয়েছে) অথবা partial (আংশিক: কিছু ইউনিট ডেলিভারি হয়েছে, বাকিগুলো রিফান্ড হয়েছে)। প্রতিটি sub_transactions[].status-এর মান প্রথম তিনটি মানের যেকোনো একটি হয়; কোনো ইউনিট ডেলিভারি বা রিফান্ড না হওয়া পর্যন্ত সেটি পেন্ডিং থাকে। sub_transactions[].id হলো অর্ডারের ভেতরে ইউনিটের ক্রমিক নম্বর (1…n), এটি ডেটাবেসের কোনো id নয়। retry_count ও max_retries যেখানে থাকে, সেখানে এগুলো ডেপ্রিকেটেড এবং মান সবসময় 0।

পাথ প্যারামিটার

নামধরনআবশ্যকবিবরণউদাহরণ
orderIdstring (UUID)হ্যাঁযে অর্ডারটি খুঁজবেন, তার ID।01912345-6789-7abc-8def-0123456789ab
রিকোয়েস্ট
curl -s "https://shop2topup.com/api/endpoints/v1/orders/01912345-6789-7abc-8def-0123456789ab" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
রেসপন্সের উদাহরণ
{
  "success": true,
  "order": {
    "order_id": "01912345-6789-7abc-8def-0123456789ab",
    "status": "completed",
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "subcategory_name": "FF 100 Diamonds",
    "quantity": 1,
    "charged_amount": "0.950000",
    "currency": "USD",
    "created_at": "2024-06-15T12:00:00Z",
    "completed_at": "2024-06-15T12:00:05Z",
    "vouchers": [],
    "sub_transactions": [
      {
        "id": 1,
        "status": "completed",
        "player_id": "123456789",
        "player_name": "ProGamer99",
        "amount": "0.950000",
        "created_at": "2024-06-15T12:00:00Z",
        "completed_at": "2024-06-15T12:00:05Z"
      }
    ]
  }
}
POST

/orders/batch

একসাথে কয়েকটি অর্ডার দেখুন

ID দিয়ে একবারে একাধিক অর্ডার দেখুন। প্রতি রিকোয়েস্টে সর্বোচ্চ 50টি অর্ডার ID দেওয়া যাবে।

রেট লিমিটপ্রতি অ্যাকাউন্টে 60 সেকেন্ডে 2 রিকোয়েস্ট

রিকোয়েস্ট বডি

নামধরনআবশ্যকবিবরণউদাহরণ
order_idsstring[]হ্যাঁঅর্ডার UUID-এর অ্যারে (সর্বোচ্চ 50টি)।["uuid-1", "uuid-2"]
রিকোয়েস্ট
curl -s -X POST "https://shop2topup.com/api/endpoints/v1/orders/batch" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "order_ids": [
    "uuid-1",
    "uuid-2"
  ]
}'
রেসপন্সের উদাহরণ
{
  "success": true,
  "orders": [
    {
      "order_id": "01912345-6789-7abc-8def-0123456789ab",
      "status": "completed",
      "charged_amount": "0.950000"
    }
  ],
  "not_found": [
    "uuid-that-does-not-exist"
  ]
}
GET

/orders

অর্ডারের তালিকা

পেজিনেশনসহ আপনার অর্ডারের তালিকা দেখুন। চাইলে স্ট্যাটাস ও তারিখের রেঞ্জ দিয়ে ফিল্টারও করতে পারেন।

রেট লিমিটপ্রতি অ্যাকাউন্টে 60 সেকেন্ডে 2 রিকোয়েস্ট

কোয়েরি প্যারামিটার

নামধরনআবশ্যকবিবরণউদাহরণ
pagenumberনাপেজ নম্বর (ডিফল্ট: 1)।1
limitnumberনাপ্রতি পেজে ফলাফলের সংখ্যা, 1-100 (ডিফল্ট: 50)।50
statusstringনাস্ট্যাটাস অনুযায়ী ফিল্টার করুন: পেন্ডিং, সম্পন্ন, রিফান্ড হয়েছে, আংশিক।completed
created_afterstring (ISO 8601)নাএই তারিখের পরে তৈরি হওয়া অর্ডারগুলো ফিল্টার করুন।2024-01-01T00:00:00Z
created_beforestring (ISO 8601)নাএই তারিখের আগে তৈরি হওয়া অর্ডারগুলো ফিল্টার করুন।2024-12-31T23:59:59Z
রিকোয়েস্ট
curl -s "https://shop2topup.com/api/endpoints/v1/orders?page=1&limit=50&status=completed&created_after=2024-01-01T00:00:00Z&created_before=2024-12-31T23:59:59Z" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"
রেসপন্সের উদাহরণ
{
  "success": true,
  "orders": [
    {
      "order_id": "01912345-6789-7abc-8def-0123456789ab",
      "status": "completed",
      "subcategory_name": "FF 100 Diamonds",
      "quantity": 1,
      "charged_amount": "0.950000",
      "created_at": "2024-06-15T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "total_pages": 1
  }
}

এই পেজ থেকেই আসল রিকোয়েস্ট পাঠান

এই এন্ডপয়েন্টগুলো লাইভ কল করতে একটি API key পেস্ট করুন। key এই ব্রাউজার ট্যাবেই থাকে এবং শুধু API-তেই পাঠানো হয়।

Enter your API key to use the interactive playground. Get your API key

এন্ডপয়েন্ট বেছে নিন

1
2
Order Details

Enter your API key above to try this endpoint.

প্ল্যাটফর্মে নতুন হলে রিসেলারদের জন্য গেম টপ আপ API ওভারভিউ, অথবা SHOP2TOPUP রিসেলার প্রোগ্রামের পরিচিতি পড়ে জেনে নিন পার্টনার অ্যাকাউন্ট কীভাবে কাজ করে।

অর্ডার API রেফারেন্স: অর্ডার তৈরি, দেখা, ব্যাচ ও তালিকা