Cüzdan: ön ödemeli kredi, yükleme, otomatik tahsilat

Faturalama ön ödemeli cüzdan üzerinden işler. Kredi yüklersiniz, dakika ve mesaj harcadıkça bakiye düşer, bitmeden yeniden yüklersiniz. Sürpriz fatura, kredi limiti onayı veya sözleşme yok — harcama tavanınız yüklediğiniz tutardır.

Cüzdan hesabın tamamına aittir

Cüzdan kullanıcı veya asistan bazında değil, çalışma alanı (hesap) bazındadır. Ekipteki her kullanıcının başlattığı her arama aynı bakiyeden düşer. Böylece toplam harcamayı tek yerden izlersiniz.

Bakiyeyi görmek

Panelde sağ üstteki Cüzdan bölümünden görebilirsiniz. API tarafında bakiye, özet ve işlem geçmişi ayrı uçlardan gelir.

# Bakiye
curl https://api.call2me.app/v1/wallet/balance \
  -H "Authorization: Bearer sk_live_..."

# Özet (bakiye + son dönem harcama)
curl https://api.call2me.app/v1/wallet/summary \
  -H "Authorization: Bearer sk_live_..."

# İşlem geçmişi
curl "https://api.call2me.app/v1/wallet/transactions?limit=50" \
  -H "Authorization: Bearer sk_live_..."

{
  "balance_usd": 47.23,
  "currency": "USD"
}

Yükleme yolları

1. 1Panel — Cüzdan → Bakiye Yükle → tutarı girin → kartla ödeyin. Tek seferlik yüklemeler için en pratik yol.
2. 2API — POST /v1/wallet/topup ile tutar ve ödeme yöntemi göndererek yükleme başlatın.
3. 3Otomatik tahsilat — bakiye belirlediğiniz eşiğin altına düştüğünde kayıtlı karttan otomatik yükleme yapılır.

curl -X POST https://api.call2me.app/v1/wallet/topup \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"amount_usd": 100}'

Otomatik tahsilat

Kampanyanın ortasında bakiyenin bitmesi en can sıkıcı arıza türüdür. Otomatik tahsilat tam bunu önler: iki sayı belirlersiniz ve gerisi kendiliğinden işler.

• Eşik — bakiye bu tutarın altına düştüğünde tahsilat tetiklenir.
• Yükleme tutarı — her tetiklenmede eklenecek miktar.
• Kayıtlı kart — otomatik tahsilatın çalışması için zorunlu.

Pratik kural: eşiği haftalık harcamanızın yaklaşık %10’u kadar seçin. Çok düşük bir eşik aramaların 402 ile durmasına, çok yüksek bir eşik ihtiyacınız olmayan tutarı önden bağlamanıza yol açar. Panelden dilediğiniz an kapatabilirsiniz.

# Otomatik tahsilat ayarını oku
curl https://api.call2me.app/v1/payments/auto-charge \
  -H "Authorization: Bearer sk_live_..."

# Ayarla
curl -X PUT https://api.call2me.app/v1/payments/auto-charge \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"enabled": true, "threshold_usd": 20, "amount_usd": 100}'

Hangi olay ne zaman düşer

Panelde Cüzdan → İşlemler görünümü her kaydı, ilişkili olduğu arama / sohbet / numara ile birlikte listeler. Bir kalemi merak ettiğinizde oradan ilgili aramanın detayına inebilirsiniz.

402 Payment Required ne demek

Bakiye bir aramayı başlatmaya yetmediğinde API 402 döner. Arama hiç kurulmaz; yani boşa geçen bir maliyet oluşmaz.

HTTP/1.1 402 Payment Required

{
  "error": {
    "code": "insufficient_balance",
    "message": "Wallet balance below minimum to start call",
    "balance_usd": 0.005,
    "required_usd": 0.01
  }
}

Arama başlatmak için gereken asgari bakiye $0.01’dir. Pratikte tek bir dakikayı güvenle karşılayacak kadar bakiye bırakmak daha doğrudur; otomatik tahsilat açıksa bu hatayı neredeyse hiç görmezsiniz.

Düşük bakiye uyarısı

Hesap düzeyinde webhook tanımlarsanız bakiye eşiğin altına düştüğünde wallet.low_balance olayı gönderilir (varsayılan eşik $5, günde en çok bir kez). Kendi izleme sisteminize bağlamak için doğru kanal budur.

Bayi (white-label) müşterisiyseniz

Bunun nedeni faturalamanın zincir halinde işlemesidir: kullanım bayinin hesabından düşer, bayi de kendi müşterilerine kredi tanımlar. Bu yüzden bayi müşterisinin ödeme sağlayıcısıyla doğrudan bir ilişkisi olmaz.

Krediler ve iade

• Krediler zaman aşımına uğramaz; harcanana kadar cüzdanda kalır.
• Kullanılmamış kredi, yükleme tarihinden itibaren 14 gün içinde iade edilebilir.
• Doğrulanmış yeni hesaplara test için başlangıç kredisi tanımlanır — kart bilgisi gerekmez.