getBalance

Renvoie le solde du portefeuille du compte propriétaire de la clé, ainsi que le palier de volume actuellement appliqué. L'appel est gratuit et sans risque à intervalle régulier — beaucoup d'intégrations s'en servent comme test de disponibilité économique.

POST https://api.captchapi.com/getBalance
content-type: application/json

{ "clientKey": "YOUR_API_KEY" }

{
  "errorId": 0,
  "balance": 42.815,
  "currency": "USD",
  "tier": "Silver",
  "discount": 0.1
}

balance est exprimé en dollars américains sous forme de nombre décimal. En interne nous le stockons en micro-dollars entiers : la valeur affichée est donc exacte et non un flottant arrondi. discount est la fraction retirée du prix public par votre palier : 0,1 signifie que chaque résolution coûte 10 % de moins que le tarif publié.

Alertez sur le solde, pas sur les échecs. Un portefeuille qui tombe à zéro renvoie ERROR_ZERO_BALANCE sur createTask, ce qui ressemble à une panne dans vos journaux alors que c'est un événement de facturation.