/orders/create
অর্ডার তৈরি করুন
নতুন অর্ডার দিন। idempotency-র জন্য order_id হিসেবে একটি ইউনিক UUID দিতেই হবে। ওয়ালেট থেকে সঙ্গে সঙ্গে দাম কেটে নেওয়া হবে।
রেট লিমিটপ্রতি অ্যাকাউন্টে 60 সেকেন্ডে 5000 রিকোয়েস্ট
নোট: order_id-ই আপনার idempotency key। একই UUID দিয়ে আবার চেষ্টা করলে ডুপ্লিকেট অর্ডার তৈরি হবে না, আগের অর্ডারটিই ফেরত আসবে।
রিকোয়েস্ট বডি
| নাম | ধরন | আবশ্যক | বিবরণ | উদাহরণ |
|---|---|---|---|---|
| order_id | string (UUID) | হ্যাঁ | এই অর্ডারের জন্য একটি ইউনিক UUID (যেকোনো ফরম্যাট চলবে: v1, v4, v7 ইত্যাদি)। এটি idempotency key হিসেবে ব্যবহার হয়। | 01912345-6789-7abc-8def-0123456789ab |
| sub_category_id | number | হ্যাঁ | প্রোডাক্টের সাবক্যাটাগরি ID। | 999 |
| quantity | number | হ্যাঁ | কত ইউনিট অর্ডার করবেন (ধনাত্মক পূর্ণসংখ্যা)। | 1 |
| requirements | object | হ্যাঁ | প্লেয়ারের ডেলিভারি তথ্য। ক্যাটাগরির রিকোয়ারমেন্ট এন্ডপয়েন্ট যে ফিল্ডগুলো দেয়, তার সবগুলোই দিন। | {"player_id": "123456789", "server": "Asia"} |
| expected_unit_price | string | না | দামের সুরক্ষা। বর্তমান দাম এই মানের চেয়ে বেশি হলে অর্ডার নেওয়া হবে না। | 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"
}
}