Fonctions de l'API Solde

Obtenir le solde

Obtenir le solde d'un compte Stripe.

Point final : https://api.stripe.com/v1/balance

Opération : GET

Exemples

cURL Exemple:

curl -X GET `https://api.stripe.com/v1/balance` \
  -u <YOUR_SECRET_KEY>:

Réponses

Les réponses renvoient des codes standard.

200 : OK

{
  "object" : "balance",
  "available" : [
    {
      "montant" : 0,
      "devise" : "usd",
      "source_types" : {
        "card" : 0
      }
    }
  ],
  "livemode" : false,
  "pending" : [
    {
      "amount" : 0,
      "devise" : "usd",
      "source_types" : {
        "card" : 0
      }
    }
  ],
  "refund_and_dispute_prefunding" : {
    "available" : [
      {
        "montant" : 0,
        "devise" : "usd"
      }
    ],
    "pending" : [
      {
        "montant" : 0,
        "devise" : "usd"
      }
    ]
  }
}

Réponses aux erreurs

400 : Mauvaise demande

{
  "error" : {
    "message" : "Si vous passez un tableau avec des clés explicites (par exemple foo[0]=a&foo[1]=b) au lieu d'un tableau (par exemple foo[]=a&foo[]=b), les clés doivent être numériques et séquentielles à partir de 0. Vous avez passé les clés `1`, nous nous attendions à avoir une clé avec la valeur `0`.",
    "param" : "expand",
    "request_log_url" : "https://dashboard.stripe.com/test/logs/req_kCeAL5FAly5bkh?t=1734734555",
    "type" : "invalid_request_error"
  }
}

401 : Non autorisé

{
  "error" : {
    "type" : "invalid_request_error",
    "message" : "Invalid API Key provided : sk_test_********************1234"
  }
}

Paramètres

Paramètres de la requête

Paramètre	Type	Description
expand[]	tableau de chaînes	Spécifie quels champs de la réponse doivent être développés.

Récupérer une transaction de solde

Renvoie les transactions qui composent le solde du compte Stripe (par exemple, les frais, les transferts, les paiements, les remboursements, etc.) Les transactions sont retournées dans l'ordre, les plus récentes apparaissant en premier.

Point de terminaison : https://api.stripe.com/v1/balance_transactions/{id}

Opération : GET

Exemples

cURL Exemple:

curl -X GET https://api.stripe.com/v1/balance_transactions/tr_1234567890 \
  -u <YOUR_SECRET_KEY>:

Réponses

Les réponses renvoient des codes standard.

200 : OK

{
  "object" : "balance_transaction",
  "id" : "tr_1234567890",
  "montant" : 1000,
  "currency" : "usd",
  "description" : "Paiement de la facture",
  "frais" : 59,
  "fee_details" : [
    {
      "amount" : 59,
      "currency" : "usd",
      "description" : "Frais de traitement Stripe",
      "type" : "stripe_fee"
    }
  ],
  "net" : 941,
  "status" : "disponible",
  "type" : "charge"
}

400 : Bad Request

{
  "error" : {
    "message" : "Si vous passez un tableau avec des clés explicites (par exemple foo[0]=a&foo[1]=b) au lieu d'un tableau (par exemple foo[]=a&foo[]=b), les clés doivent être numériques et séquentielles à partir de 0. Vous avez passé les clés `1`, nous nous attendions à avoir une clé avec la valeur `0`.",
    "param" : "expand",
    "request_log_url" : "https://dashboard.stripe.com/test/logs/req_kCeAL5FAly5bkh?t=1734734555",
    "type" : "invalid_request_error"
  }
}

401 : Non autorisé

{
  "error" : {
    "type" : "invalid_request_error",
    "message" : "Invalid API Key provided : sk_test_********************1234"
  }
}

Paramètres

Paramètres de la requête

Paramètre	Type	Description
expand[]	tableau de chaînes	Spécifie quels champs de la réponse doivent être développés.

Variables de chemin

Nom	Type	Requis	Description
id	chaîne de caractères	Obligatoire	Identifiant de la variable de chemin d'accès