# Fonctionnement des cartes Stripe Issuing

Découvrez comment intégrer Stripe Issuing à Financial Accounts pour les plateformes.

> #### Compatibilité de l'API Accounts v2
> 
> L’API Accounts v2 ne prend pas en charge des workflows Issuing. Si vous avez des comptes créés avec Accounts v2, vous pouvez utiliser Accounts v1 pour gérer les fonctionnalités `treasury` et `card_issuing`. Pour en savoir plus, consultez la page [Utilisez l’objet Accounts en tant que clients](https://docs.stripe.com/connect/use-accounts-as-customers.md).

[Stripe Issuing](https://docs.stripe.com/issuing.md) vous permet de créer des cartes physiques et virtuelles alimentées par un compte financier.

## Activer Issuing pour les comptes connectés

Demandez la [fonctionnalité](https://docs.stripe.com/connect/account-capabilities.md) `card_issuing` pour les comptes connectés de votre plateforme et fournissez les [informations requises](https://docs.stripe.com/issuing/connect.md#required-verification-information) pour l’inscription.

```curl
curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "capabilities[treasury][requested]=true" \
  -d "capabilities[card_issuing][requested]=true" \
  -d "capabilities[transfers][requested]=true"
```

En cas de succès, la réponse renvoie l’[objet Account](https://docs.stripe.com/api/accounts/object.md) du compte connecté avec le hachage des `capabilities` répertoriant les fonctionnalités demandées comme `active`.

Si ce n’est pas encore fait, demandez également l’accès à la fonctionnalité `card_issuing` pour le compte financier.

```curl
curl https://api.stripe.com/v1/treasury/financial_accounts/{{TREASURYFINANCIALACCOUNT_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "treasury[access][requested]=true" \
  -d "card_issuing[access][requested]=true"
```

Sauf échec de l’opération, la réponse renvoie l’objet FinancialAccount avec les fonctionnalités présentes dans le tableau `active_features` ou `pending_features`.

## Créer une carte bancaire

Une fois la fonctionnalité `card_issuing` activée, les marchands et les fournisseurs de services propriétaires d’un compte connecté sur votre plateforme peuvent créer des titulaires de cartes et des cartes. Vous ne pouvez émettre des cartes que via l’API.

Un [objet Cardholder](https://docs.stripe.com/api/.md#issuing_cardholder_object) représente une entité (particulier ou entreprise) pour laquelle des cartes peuvent être émises. Pour commencer, créez un `Cardholder` en renseignant le nom, les informations de facturation et en précisant s’il s’agit d’un `individual` ou d’une `company`.

```curl
curl https://api.stripe.com/v1/issuing/cardholders \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "name=Jenny Rosen" \
  --data-urlencode "email=jenny.rosen@example.com" \
  --data-urlencode "phone_number=+18008675309" \
  -d status=active \
  -d type=individual \
  -d "individual[first_name]=Jenny" \
  -d "individual[last_name]=Rosen" \
  -d "individual[dob][day]=1" \
  -d "individual[dob][month]=11" \
  -d "individual[dob][year]=1981" \
  -d "billing[address][line1]=1234 Main Street" \
  -d "billing[address][city]=San Francisco" \
  -d "billing[address][state]=CA" \
  -d "billing[address][postal_code]=94111" \
  -d "billing[address][country]=US"
```

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

Créez un objet [Card](https://docs.stripe.com/api/.md#issuing_card_object) et affectez-le au `Cardholder` que vous venez de créer et à un compte financier. Pour affecter le titulaire de la carte et le compte financier, indiquez l’ID du titulaire dans le paramètre `cardholder` et l’ID du compte financier dans le paramètre `financial_account` de la requête `/v1/issuing/cards`.

```curl
curl https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d cardholder={{CARDHOLDER_ID}} \
  -d "financial_account={{TREASURYFINANCIALACCOUNT_ID}}" \
  -d currency=usd \
  -d type=virtual \
  -d status=active
```

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

## Gérer les autorisations

Pour gérer les autorisations en bonne et due forme, consultez le guide consacré aux [autorisations Issuing](https://docs.stripe.com/issuing/purchases/authorizations.md).

### Créer des autorisations de test

Vous pouvez tester les cartes que vous venez d’émettre en suivant les étapes de la section [Tests Issuing](https://docs.stripe.com/issuing/testing.md) pour simuler des achats.

Si le compte financier associé à la carte émise présente des restrictions pour les [outbound_flows](https://docs.stripe.com/api/treasury/financial_accounts/create.md#create_financial_account-platform_restrictions-outbound_flows), les autorisations sur la carte ne sont pas accordées.

Pour en savoir plus sur les différents types de transactions que vous pourriez tester, consultez le guide consacré aux [transactions Issuing](https://docs.stripe.com/issuing/purchases/transactions.md#handling-other-transactions).

## Gérer les captures et les remboursements

Pour en savoir plus sur la gestion des remboursements et des captures, consultez le guide consacré aux [transactions Issuing](https://docs.stripe.com/issuing/purchases/transactions.md).

## Gérer les litiges

Pour comprendre comment gérer des litiges en bonne et due forme, consultez le guide consacré aux [litiges Issuing](https://docs.stripe.com/issuing/purchases/disputes.md).