TikTok Coin Toplu Otomatik Yükleme

Ajans, MCN veya yayıncı ekibin varsa manuel tek tek yükleme yapmak zaman kaybı. Otomatik toplu yükleme ile 50-500 hesap 5-15 dakikada dolar. Bu rehberde Excel upload, API entegrasyonu ve hata yönetimi süreçlerini adım adım anlatıyoruz.

Toplu Otomatik Yükleme Nedir?

Tek bir talep ile onlarca (veya yüzlerce) TikTok hesabına farklı miktarlarda coin yüklemek. İki ana yöntem:

• Excel/CSV Upload: Web paneli üzerinden dosya yükleme.
• API Entegrasyonu: Kendi sisteminden otomatik sipariş.

Yöntem 1: Excel Upload

Excel Format

Yükleme Adımları

1. Kurumsal panel → "Toplu Yükleme" sekmesi.
2. "Dosya Seç" → Excel/CSV dosyanı yükle.
3. Sistem dosyayı validate eder (kullanıcı adı, paket kodu, miktar kontrolü).
4. Hata varsa ekranda liste görünür; düzeltip yeniden yükle.
5. "Onayla ve Öde" → toplam tutar + iskonto uygulanır.
6. Ödeme yöntemini seç (havale, açık hesap, kripto).
7. Onay sonrası sipariş queue'ya alınır.
8. 5-15 dakika içinde tüm hesaplar dolar.

Validasyon Kontrolleri

• Kullanıcı adı geçerli mi (TikTok üzerinde bulunuyor mu)?
• Paket kodu doğru mu?
• Miktar sıfırdan büyük mü?
• Kurumsal limit aşıldı mı?
• Aynı kullanıcı adında duplike var mı?

Yöntem 2: API Entegrasyonu

API Uç Noktaları

POST /api/v1/bulk-order
Authorization: Bearer YOUR_API_KEY

{
  "orders": [
    {
      "tiktok_username": "@yayinci1",
      "package_code": "PKG_7000",
      "quantity": 2
    },
    {
      "tiktok_username": "@yayinci2",
      "package_code": "PKG_1400",
      "quantity": 5
    }
  ],
  "payment_method": "credit_account",
  "callback_url": "https://senin-sitene.com/webhook"
}

Yanıt

{
  "order_id": "BLK-20260111-001",
  "status": "queued",
  "total_amount": "12450.00 TRY",
  "discount_applied": "-8%",
  "estimated_completion": "2026-01-11T14:35:00Z",
  "orders": [
    { "row": 1, "status": "queued", "sub_order_id": "SUB-001" },
    { "row": 2, "status": "queued", "sub_order_id": "SUB-002" }
  ]
}

Webhook Bildirimi

Her sipariş tamamlandığında callback_url'ye POST atılır:

{
  "sub_order_id": "SUB-001",
  "tiktok_username": "@yayinci1",
  "package_code": "PKG_7000",
  "status": "completed",
  "completed_at": "2026-01-11T14:33:12Z"
}

Hata Yönetimi

Yaygın Hatalar

Retry Stratejisi

Geçici hatalar (5xx sunucu hatası, timeout) için exponential backoff öneririz:

retry 1: 5 saniye sonra
retry 2: 15 saniye sonra
retry 3: 45 saniye sonra
retry 4: 3 dakika sonra
retry 5: 15 dakika sonra (max)

Rate Limit

API kullanımında saatlik limit:

• Starter: 100 istek/saat
• Pro: 1.000 istek/saat
• Enterprise: 10.000 istek/saat

Limit aşımında 429 status code döner; Retry-After header'ında bekleme süresi belirtilir.

Teslim Raporu

Toplu sipariş tamamlandığında rapor:

• Toplam sipariş sayısı
• Başarılı yüklenme sayısı
• Başarısız (ve sebep)
• Toplam yüklenen coin/jeton miktarı
• Faturaya yansıyan tutar (KDV dahil)

Excel/PDF olarak indirilebilir. Muhasebe entegrasyonu için CSV.

Duplike ve Çakışma Kontrolü

Aynı hesaba 30 dakika içinde birden fazla yükleme yapılırsa "duplike" olarak işaretlenir. Bu koruma yanlışlıkla iki kez sipariş vermeni engeller. Kasıtlı duplike gönderiyorsan API'de allow_duplicate: true flag'i kullan.

Sandbox Test Ortamı

Canlıya geçmeden önce sandbox API'sinde test yap:

• URL: sandbox-api.jetonsepetim.com.tr
• Test API anahtarı ile gerçek ödeme çekmeden sipariş simülasyonu.
• Webhook test alıcısı ile veri akışını doğrula.

Güvenlik

• API anahtarını asla frontend'de bulundurma.
• Backend'inden istek gönder.
• HMAC imza ile webhook doğrulaması yap.
• IP whitelist ekle.
• Anahtar kaybolursa hemen rotate et.

Kapanış

Otomatik toplu yükleme; zaman + iş gücü + hata azaltma demek. Küçük ekipler Excel upload ile başlayıp büyüdükçe API'ye geçebilir. İletişim üzerinden API anahtarı talebi aç, sandbox'ta test et, canlıya geç.