/orders/create
ثبت سفارش
یک سفارش جدید ثبت میکند. برای جلوگیری از ثبت تکراری، باید یک UUID یکتا را بهعنوان order_id بفرستید. مبلغ سفارش بلافاصله از کیف پول کسر میشود.
محدودیت نرخ۵۰۰۰ درخواست در ۶۰ ثانیه برای هر حساب
نکته: order_id کلید جلوگیری از تکرار (idempotency key) شماست. اگر با همان UUID دوباره درخواست بفرستید، به جای ساخت سفارش تکراری، همان سفارش قبلی برگردانده میشود.
بدنه درخواست
| نام | نوع | الزامی | توضیح | نمونه |
|---|---|---|---|---|
| order_id | string (UUID) | بله | یک UUID یکتا برای این سفارش (هر نسخهای: v1، v4، v7 و غیره). بهعنوان کلید جلوگیری از تکرار (idempotency key) استفاده میشود. | 01912345-6789-7abc-8def-0123456789ab |
| sub_category_id | number | بله | شناسه زیردسته محصول. | 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"
}
}