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

Sipariş Oluştur

Yeni sipariş ver. Idempotency için order_id olarak benzersiz bir UUID göndermen gerekir. Tutar cüzdanından hemen düşülür.

Hız sınırıHesap başına 60 sn'de 5000 istek

Not: order_id, idempotency anahtarı olarak çalışır. Aynı UUID ile tekrar denersen yeni bir kopya oluşmaz, mevcut sipariş döner.

İstek gövdesi

Ad	Tür	Zorunlu	Açıklama	Örnek
order_id	string (UUID)	Evet	Bu sipariş için benzersiz bir UUID (her sürüm olur: v1, v4, v7 vb.). Idempotency anahtarı olarak kullanılır.	01912345-6789-7abc-8def-0123456789ab
sub_category_id	number	Evet	Ürünün alt kategori ID'si.	999
quantity	number	Evet	Sipariş edilecek adet (pozitif tam sayı).	1
requirements	object	Evet	Oyuncuya teslimat bilgileri. Kategori Gereksinimlerini Getir uç noktasının döndürdüğü tüm alanları ekle.	{"player_id": "123456789", "server": "Asia"}
expected_unit_price	string	Hayır	Fiyat koruması. Güncel fiyat bu değeri aşarsa sipariş reddedilir.	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

Sipariş Durumunu Sorgula

Belirli bir siparişin güncel durumunu ve detaylarını al.

Hız sınırıHesap + order_id başına 60 sn'de 3 istek

Not: Sipariş durumu pending, completed, refunded ya da partial olur (partial: birimlerin bir kısmı teslim edildi, kalanı iade edildi). Her bir sub_transactions[].status değeri pending, completed ya da refunded olur; bir birim teslim edilene ya da iade edilene kadar pending kalır. Buradaki sub_transactions[].id, birimin sipariş içindeki sırasını (1…n) gösterir, veritabanı kimliği değildir. Yanıtta retry_count ve max_retries görürsen bunlar kullanımdan kalkmıştır ve her zaman 0 döner.

Yol parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
orderId	string (UUID)	Evet	Sorgulanacak sipariş ID'si.	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

Siparişleri Toplu Getir

Birden fazla siparişi ID'leriyle tek seferde al. İstek başına en fazla 50 sipariş ID'si gönderebilirsin.

Hız sınırıHesap başına 60 sn'de 2 istek

İstek gövdesi

Ad	Tür	Zorunlu	Açıklama	Örnek
order_ids	string[]	Evet	Sipariş UUID'lerinden oluşan dizi (en fazla 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

Siparişleri Listele

Siparişlerini sayfa sayfa listele; istersen duruma ve tarih aralığına göre filtrele.

Hız sınırıHesap başına 60 sn'de 2 istek

Sorgu parametreleri

Ad	Tür	Zorunlu	Açıklama	Örnek
page	number	Hayır	Sayfa numarası (varsayılan: 1).	1
limit	number	Hayır	Sayfa başına sonuç, 1-100 (varsayılan: 50).	50
status	string	Hayır	Duruma göre filtrele: pending, completed, refunded, partial.	completed
created_after	string (ISO 8601)	Hayır	Bu tarihten sonra oluşturulan siparişleri filtrele.	2024-01-01T00:00:00Z
created_before	string (ISO 8601)	Hayır	Bu tarihten önce oluşturulan siparişleri filtrele.	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.