Configurer une intégration pour Issuing et Connect

Pour émettre des cartes, chaque entreprise doit utiliser un compte connecté. Issuing prend uniquement en charge les comptes connectés qui n’utilisent pas de Dashboard hébergé par Stripe, et dont votre plateforme est responsable de la collecte des exigences et des pertes, c’est-à-dire les comptes connectés Custom. Découvrez comment créer des comptes connectés qui fonctionnent avec Issuing. Tous les comptes doivent demander les fonctionnalités de compte card_issuing et transfers.

Créer un compte

Créez un compte connecté via le Dashboard ou l’API avec l’option Créer un compte.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d country=US \
  -d "capabilities[transfers][requested]"=true \
  -d "capabilities[card_issuing][requested]"=true \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[requirement_collection]"=application

Activer Issuing sur les comptes connectés existants

Si votre plateforme dispose déjà d’une intégration Connect avec des comptes connectés, vous pouvez demander Issuing sur ces comptes via le Dashboard ou l’API.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "capabilities[card_issuing][requested]"=true

Vous pouvez également utiliser l’API pour récupérer les informations du compte et vérifier que la fonctionnalité Issuing est demandée dans la propriété capabilities. La fonctionnalité ne sera pas active tant que toutes les conditions ne seront pas réalisées. :

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

{
  "object": "list",
  "data": [
    {
      "id": "acct_1234",
      "object": "account",
    ...
      "capabilities": {
        "card_issuing": "inactive",
        "transfers": "active",
      },
    ...
      "controller": {
        "stripe_dashboard": {
          "type": "none"
        },
        "fees": {
          "payer": "application"
        },
        "losses": {
          "payments": "application"
        },
        "is_controller": true,
        "type": "application",
        "requirement_collection": "application"
      },
    },
  ...
  ]
}

Après avoir créé un compte connecté, vous devez fournir davantage d’informations sur le titulaire du compte. L’objet de fonctionnalité possède un hachage requirements qui contient les exigences de vérification d’identité currently_due. L’utilisateur doit fournir les informations détaillées dans le hachage requirements pour activer les fonctionnalités Issuing.

Si vous créez un objet Account de test et souhaitez contourner les exigences d’inscription à des fins de test, utilisez l’API de modification de compte pour fournir des valeurs de test répondant à ces exigences.

L’utilisateur fournit les informations qui lui correspondent en fonction de son type d’entreprise, qu’il s’agisse d’un particulier, d’une entreprise, d’une organisation à but non lucratif ou d’une entité publique (Stripe Treasury ne prend pas en charge les entités publiques).

Choisissez l’une des options d’inscription des utilisateurs suivantes :

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account={{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

{
  "object": "account_link",
  "created": 1612927106,
  "expires_at": 1612927406,
  "url": "https://connect.stripe.com/setup/s/…"
}

Collecter et vérifier les informations requises

Lorsque vous créez un compte connecté et demandez des fonctionnalités, la réponse renvoie une liste de toutes les informations requises. Pour connaître les exigences spécifiques à une fonctionnalité, récupérez la fonctionnalité du compte et consultez requirements.past_due.

Pour activer la fonctionnalité card_issuing, vous devez fournir les informations suivantes :

Représentants et bénéficiaires effectifs

Pour les entreprises et les organisations à but non lucratif, des informations d’inscription supplémentaires sont requises concernant les représentants (c’est-à-dire les directeurs [relationship.director] ou dirigeants [relationship.executive]), ainsi que tout bénéficiaire effectif détenant plus de 25 % des parts de l’entreprise (relationship.owner). Chaque compte connecté doit avoir au moins un représentant, qui est généralement un dirigeant ou un directeur, selon le pays. Il doit également être en mesure de justifier de l’exactitude des informations fournies. Les bénéficiaires effectifs ne sont pas obligatoires.

En savoir plus sur les bénéficiaires effectifs, représentants et directeurs.

Parfois, après avoir fourni toutes les informations requises, un compte peut avoir besoin de fournir des informations ou des documents supplémentaires. Ces nouvelles exigences figurent dans le tableau requirements.eventually_due ou dans requirements.currently_due. Configurez votre intégration de manière à utiliser des webhooks pour écouter les modifications apportées aux exigences des comptes.

Si la fonctionnalité est déjà active et que le compte ne satisfait pas les nouvelles exigences propres à cette fonctionnalité avant la date limite actuelle, la fonctionnalité deviendra inactive jusqu’à ce que les exigences soient satisfaites.

Chargements de documents

S’il est impossible de vérifier les informations d’un compte, Stripe peut exiger un document pour vérifier l’identité d’une personne (par exemple, un passeport) ou des informations sur l’entité juridique (par exemple, une lettre de l’administration fiscale). Pour satisfaire aux exigences relatives aux documents, les plateformes peuvent diriger l’utilisateur vers Connect Onboarding (où il sera invité à charger le document) ou récupérer le document auprès du compte à l’aide d’une autre interface pour le charger via l’API.

Identité non vérifiée dans les 29 jours suivant la demande initiale

Une fois qu’un compte a transmis toutes les informations requises pour ouvrir un compte Issuing et accepté les Conditions d’utilisation du service Issuing, sa demande d’ouverture de compte est complète aux yeux de Stripe. Si nous ne pouvons pas vérifier les informations d’un compte, la fonctionnalité reste inactive jusqu’à ce que le compte fournisse des informations supplémentaires ou charge un document.

Si le compte reste inactive pendant 29 jours une fois la demande effectuée, vous devez envoyer au compte un e-mail de notification pour lui indiquer que nous n’avons pas pu vérifier son identité (voir le modèle).

Stripe surveille les demandes d’ouverture de compte traitées sans vérification d’identité et prend les mesures suivantes après 29 jours en mode production et après 1 heure en mode test :

• Génère un avis destiné au compte
• Efface la fonction de hachage d’acceptation des conditions d’utilisation du service Issuing pour que l’acceptation des conditions devienne une exigence currently_due

Vous pouvez soumettre une nouvelle demande à tout moment en mettant à jour les informations de votre entreprise et en enregistrant une nouvelle acceptation des conditions d’Issuing.

Stripe vous recommande de présenter les conditions d’utilisation du service à la toute fin du processus d’inscription, pour pouvoir suivre l’avancement de la demande en vous référant à la date d’acceptation.

Manquement aux Conditions d’utilisation du service

Si Stripe relève qu’un compte Connect a enfreint les Conditions d’utilisation du service Stripe, Stripe définit la fonctionnalité Issuing du compte sur inactive, désactive toutes les cartes et notifie le compte (voir le modèle d’e-mail). Cette situation peut se produire lorsque les cartes d’un compte sont utilisées dans le cadre d’activités interdites ou autorisées sous conditions, par exemple des activités illicites, des jeux d’argent ou des ventes d’armes à feu, de contenus réservés aux adultes ou de cryptomonnaies, ou d’activités interdites pour Issuing, par exemple une utilisation à des fins personnelles, dans un cadre principalement international ou aux fins de prêts, ou toute autre utilisation abusive ou non conforme.

Comptes inactifs depuis plus de 395 jours

Stripe désactivera Issuing sur les comptes qui n’ont effectué aucune transaction par carte lors des 13 mois précédents (395 jours). Sur les comptes dotés de fonctionnalités supplémentaires, Stripe désactivera Issuing seulement en cas d’absence de paiement ou de transaction Treasury lors des 395 jours précédents et si le solde Treasury est égal ou inférieur à 9,99 USD. Si Issuing est désactivé pour cause d’inactivité, l’état de la fonctionnalité card_issuing du compte Connect passe à inactive et les exigences de fonctionnalité affichent rejected.inactivity dans disabled_reason. En savoir plus sur la gestion des comptes inactifs avec Issuing.

Un objet Cardholder représente la personne physique ou morale pour laquelle vous émettez des cartes. Pour émettre une carte virtuelle ou physique, chaque titulaire de carte doit être associé à un compte connecté. Un compte connecté peut avoir plusieurs titulaires de carte.

En savoir plus sur les cartes et titulaires de carte.

Le solde Issuing est distinct du solde principal du compte connecté. Lorsque des cartes émises sont utilisées pour effectuer des transactions, les fonds correspondant sont prélevés sur le solde Issuing.

Pour effectuer des transactions avec une carte émise, vous devez d’abord affecter des fonds au solde Issuing du compte connecté associé à cette carte. Le solde Issuing contient les fonds réservés à la carte, ce qui permet de séparer en toute sécurité ces fonds de vos gains, de vos virements et de vos fonds relevant d’autres produits Stripe. Découvrez comment alimenter des comptes connectés pour Issuing.