Sipariş uç noktaları

Siparişler, sizin ürettiğiniz bir UUID ile oluşturulur. Bu UUID idempotency anahtarıdır: yinelendiğinde iki kez tahsilat yapmak yerine orijinal siparişi döndürür. Durum daha sonra sipariş başına, elliye kadar toplu halde veya sayfalanmış bir liste olarak okunur.

POST

/orders/create

Create Order

Place a new order. You must provide a unique UUID as the order_id for idempotency. The wallet will be charged immediately.

Hız sınırı120 req / 60s per user

Not: The order_id is your idempotency key. If you retry with the same UUID, the existing order is returned instead of creating a duplicate.

İstek gövdesi

Ad	Tür	Zorunlu	Açıklama	Örnek
order_id	string (UUID)	Evet	A unique UUID for this order (any format: v1, v4, v7, etc.). Used as an idempotency key.	01912345-6789-7abc-8def-0123456789ab
sub_category_id	number	Evet	The product subcategory ID.	999
quantity	number	Evet	Number of units to order (positive integer).	1
requirements	object	Evet	Player delivery info. Include all fields returned by the Get Category Requirements endpoint.	{"player_id": "123456789", "server": "Asia"}
expected_unit_price	string	Hayır	Price protection. If current price exceeds this value, the order is rejected.	0.950000

İstek

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
}'

Örnek yanıt

{
  "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

Get Order Status

Retrieve the current status and details of a specific order.

Hız sınırı3 req / 60s per user + orderId

Yol parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
orderId	string (UUID)	Evet	The order ID to look up.	01912345-6789-7abc-8def-0123456789ab

İstek

curl -s "https://shop2topup.com/api/endpoints/v1/orders/01912345-6789-7abc-8def-0123456789ab" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

Örnek yanıt

{
  "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

Batch Get Orders

Retrieve multiple orders at once by their IDs. Maximum 50 order IDs per request.

Hız sınırı2 req / 60s per user

İstek gövdesi

Ad	Tür	Zorunlu	Açıklama	Örnek
order_ids	string[]	Evet	Array of order UUIDs (max 50).	["uuid-1", "uuid-2"]

İstek

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"
  ]
}'

Örnek yanıt

{
  "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

List Orders

List your orders with pagination and optional filters by status and date range.

Hız sınırı2 req / 60s per user

Sorgu parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
page	number	Hayır	Page number (default: 1).	1
limit	number	Hayır	Results per page, 1-100 (default: 50).	50
status	string	Hayır	Filter by status: pending, completed, refunded, partial.	completed
created_after	string (ISO 8601)	Hayır	Filter orders created after this date.	2024-01-01T00:00:00Z
created_before	string (ISO 8601)	Hayır	Filter orders created before this date.	2024-12-31T23:59:59Z

İstek

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"

Örnek yanıt

{
  "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
  }
}

Bu sayfadan gerçek bir istek gönderin

Bu uç noktaları canlı çağırmak için bir API anahtarı yapıştırın. Anahtar bu tarayıcı sekmesinde kalır ve yalnızca API'nin kendisine gönderilir.

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

Bir uç nokta seçin

Order Details

Enter your API key above to try this endpoint.

Platformda yeni misiniz? bayiler için oyun yükleme API'sine genel bakış ile başlayın veya SHOP2TOPUP bayi programına genel bakış sayfasından iş ortağı hesabının nasıl çalıştığını okuyun.