Test de l'intégration d'un compte financier

Comment garantir le bon fonctionnement de vos comptes financiers.

Stripe Treasury propose un mode production et un mode test. Vous pouvez passer d’un mode à l’autre depuis le Dashboard en utilisant le bouton d’activation/de désactivation prévu à cet effet dans le coin supérieur droit.

Coin supérieur du Dashboard avec un cadre rouge mettant en évidence le bouton d'activation du mode test.

Bouton d’activation/de désactivation du mode test

Note

Vous devez suivre les étapes de mise en production détaillées dans le guide Obtenir un accès à Treasury via une API avant de pouvoir accéder aux comptes financiers en mode production.

Pour accéder au mode test via l’API, utilisez la clé API en mode test dans vos requêtes. Cette clé n’est pas incluse dans la plupart des exemples de code de la documentation, mais vous la trouverez sur la page Développeurs de votre Dashboard. Veillez à utiliser la clé de test, qui se présente sous la forme sk_test_xxx, et non pas celle de production, au format sk_live_xxx.

Avant de créer un compte financier de test, créez un compte connecté de test en utilisant POST /v1/accounts. Utilisez l’ID du compte connecté reçu en réponse pour affecter à ce compte le compte financier que vous allez créer à l’étape suivante. Treasury n’est pris en charge qu’aux États-Unis, vous devez donc définir le paramètre country sur US. Vous devez également demander les fonctionnalités requises par Treasury pour le compte connecté. Prenez note de la valeur id renvoyée dans la réponse. Comme évoqué plus haut, vous devez la spécifier comme valeur de l’en-tête Stripe-Account dans l’exemple de code suivant.

Sauf échec de l’opération, la réponse renvoie le nouvel objet Account du compte connecté.

{
  "id": "{{CUSTOM_ACCOUNT_ID}}",
  "livemode": false,
  ...
}

Créez ensuite un compte financier à l’aide de POST /v1/treasury/financial_accounts. Spécifiez l’ID du compte connecté créé à l’étape précédente comme valeur de l’en-tête Stripe-Account. Seule la valeur supported_currencies[] définie sur usd est requise dans le corps. Pour en savoir plus sur les comptes financiers, consultez la page Fonctionnement des comptes financiers ou la section de la documentation de l’API consacrée à l’objet FinancialAccount.

Sauf échec de l’opération, la réponse renvoie le nouvel objet FinancialAccount.

{
  "id": "{{FINANCIAL_ACCOUNT_ID}}",
  "livemode": false,
  "active_features": [],
  "pending_features": [],
  "restricted_features": ["financial_addresses.aba"],
  ...
}

Vous possédez désormais un compte financier en mode test associé à un compte connecté en mode test. Toutefois, comme vous n’avez pas procédé à l’inscription du compte connecté, certaines informations requises ne figurent pas dans le hachage requirements. Si vous appelez GET /v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}} à l’aide de l’ID du compte financier renvoyé dans la réponse JSON de l’instruction précédente, vous pouvez constater que le tableau de hachages financial_addresses comporte une entrée pour l’aba demandé. Son status est défini sur restricted, car le compte connecté a des exigences en retard (requirements_past_due).

{
  …
  "financial_addresses": {
    "aba": {
      "requested": true,
      "status": "restricted",
      "status_details": [
        {
          "code": "requirements_past_due",
          "resolution": "provide_information"
        }
      ]
    }
  }
  …
}

Pour activer les fonctionnalités requises sur votre compte financier en mode test sans procéder à l’inscription du compte connecté, vous devez utiliser POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} et renseigner des valeurs de test qui remplissent toutes les exigences. La requête suivante utilise un compte connecté créé précédemment afin de fournir les informations requises sur le compte.

Note

Vous ne pouvez pas créer de compte financier en mode test associé à un compte connecté en mode production.