API ile Bakiye Sorgulama ve Bütçe Kontrolü

API entegrasyonunda bakiye kontrolü, siparişlerin yetersiz bakiye nedeniyle reddedilmesini azaltır. Güncel hesap bakiyesi action=balance isteğiyle sorgulanır.

Bakiye sorgusu

POST https://roketbayim.com/api/v2
key=your_api_key
action=balance

{
  "balance": "100.84",
  "currency": "USD"
}

balance alanı kullanılabilir tutarı, currency alanı ise para birimini belirtir. Finansal hesaplamalarda ondalık değerleri kayan noktalı sayı yerine hassas para tipi veya sabit basamaklı ondalık yapı ile işlemeniz önerilir.

Sipariş öncesi bütçe kontrolü

Önbellekleme ve eş zamanlılık

Arayüzde gösterim için bakiye kısa süreli önbelleğe alınabilir; ancak kritik sipariş kararı için eski bir değere güvenmeyin. Birden fazla işçi aynı hesabı kullanıyorsa yerel rezervasyon veya kuyruk mantığıyla eş zamanlı harcamaları yönetin.

Yetersiz bakiye durumunda

Toplu sipariş isteği gereken ve kullanılabilir tutarı içeren bir yetersiz bakiye hatası döndürebilir. İşlemi otomatik ve sınırsız biçimde tekrarlamak yerine kaydı beklemeye alın, bakiyeyi yeniden sorgulayın ve kullanıcıya açık bir işlem durumu gösterin.

Para birimini sabit varsaymayın; her zaman API yanıtındaki currency alanını esas alın.