> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API Solde de crédits : facturation KYC > Consultez votre solde de crédits Didit et les paramètres de recharge automatique. Un seul solde couvre tous les produits, forfait et recharges. Prompt pour obtenir le solde de crédit Copier le prompt dans le presse-papiers \

\`Goal: Read the organization's current pre-paid credit balance (USD) plus its auto-refill configuration.

Endpoint: GET https://verification.didit.me/v3/billing/balance/
Auth header: x-api-key: 

curl:
curl -X GET 'https://verification.didit.me/v3/billing/balance/' \
-H 'x-api-key: YOUR_API_KEY'

Response 200:
\{
"balance": "1234.5600",                  // USD, FIXED-POINT DECIMAL STRING — parse with Decimal/BigDecimal, not float.
"auto_refill_enabled": true,             // boolean
"auto_refill_amount": "500.00",          // USD string or null
"auto_refill_threshold": "100.00"        // USD string or null — auto-refill fires when balance falls below this
}

Notes:
\- Balance is ORGANIZATION-WIDE — shared across every application under the same org.
\- Decreases as verifications are billed; increases when a top-up settles via Stripe webhook.
\- Currency is always USD.
\- Configure auto-refill in Console → Billing; requires a saved Stripe payment method (card, SEPA, or US ACH). The auto-refill amount is $50 to $20,000, added at face value, the same range as a manual top-up.
\- Poll at a low cadence (every few minutes max) — balance only changes when usage is billed or a top-up settles.

Common patterns:
\- Gate session creation in production — stop opening new sessions if balance drops below your operational floor.
\- Power internal dashboards / low-balance alerts.
\- Detect misconfigured auto-refill: auto_refill_enabled=true with null auto_refill_amount/threshold means it's effectively off (or no eligible payment method on file).

Failure modes (envelope {"detail": "..."}):
\- 401 — missing/malformed x-api-key.
\- 403 — key valid but bound application not allowed to read billing.
\- 429 — rate-limited.

See /getting-started/pricing for the credit consumption model and POST /v3/billing/top-up/ to add funds programmatically.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
Coller dans ## OpenAPI ````yaml fr/openapi-25.json GET /v3/billing/balance/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de vérification d'identité. Authentifiez-vous avec l'en-tête x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/billing/balance/: get: tags: - Billing summary: Obtenir le solde de crédits description: >- Obtenir le solde actuel de crédits prépayés en USD (à l'échelle de l'organisation) ainsi que la configuration de recharge automatique. Les montants sont des chaînes décimales — analysez-les avec une bibliothèque décimale. operationId: get_billing_balance responses: '200': description: >- Solde de crédits actuel ainsi que la configuration de recharge automatique de l'organisation. content: application/json: schema: type: object required: - balance - auto_refill_enabled properties: balance: type: string description: >- Solde de crédits prépayés actuel en USD, sous forme de chaîne décimale à virgule fixe. Diminue au fur et à mesure que les vérifications sont facturées et augmente lorsqu'une recharge est finalisée. auto_refill_enabled: type: boolean description: >- Lorsque la valeur est `true`, Didit débitera automatiquement le moyen de paiement enregistré pour ajouter des crédits dès que le solde franchit `auto_refill_threshold`. Configuré depuis Console → Facturation. auto_refill_amount: type: string nullable: true description: >- Montant en USD qui sera débité et ajouté au solde à chaque recharge automatique, à sa valeur nominale. À définir entre \$50 et \$20,000 dans Console → Facturation. `null` lorsque la recharge automatique est désactivée ou non configurée. auto_refill_threshold: type: string nullable: true description: >- Seuil de déclenchement en USD. Le rechargement automatique se déclenche lorsque `balance` descend en dessous de cette valeur. `null` lorsque le rechargement automatique est désactivé ou non configuré. examples: Healthy balance with auto-refill: value: balance: '1234.5600' auto_refill_enabled: true auto_refill_amount: '500.00' auto_refill_threshold: '100.00' Low balance, manual top-up only: value: balance: '12.0000' auto_refill_enabled: false auto_refill_amount: null auto_refill_threshold: null '403': description: >- Clé API manquante, invalide ou révoquée, ou la clé ne peut pas lire les données de facturation pour cette organisation. Une clé manquante renvoie `403` ; une clé incorrecte, révoquée ou expirée renvoie `401`. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '429': description: >- Limite de débit dépassée ; réduisez la cadence et réessayez après l'intervalle indiqué dans `Retry-After`. content: application/json: examples: Throttled: value: detail: Request was throttled. Expected available in 30 seconds. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X GET 'https://verification.didit.me/v3/billing/balance/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.billing.retrieve_balance() print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.billing.retrieveBalance(); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Billing.RetrieveBalance(ctx)\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.billing().retrieveBalance(); System.out.println(result); - lang: php label: PHP source: |- billing->retrieveBalance(); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.billing.retrieve_balance puts result.to_h - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Billing.RetrieveBalanceAsync(); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.