# Comptes connectés, cartes et titulaires de carte

Découvrez comment créer et gérer des cartes et titulaires de carte avec Stripe Connect.

Les comptes connectés représentent des entités commerciales. Les titulaires de carte représentent les personnes associées à ces entités commerciales. Un compte connecté peut avoir plusieurs titulaires de carte. Par exemple, un compte connecté appartenant à une petite entreprise peut disposer de plusieurs titulaires de carte pour le propriétaire et les employés. Une fois le titulaire de carte créé, vous pouvez émettre une carte virtuelle ou physique pour ce titulaire.
Cartes et titulaires de carte des comptes connectés (See full diagram at https://docs.stripe.com/issuing/connect/cardholders-and-cards)
## Créer des titulaires de carte

Pour créer un objet [Cardholder](https://docs.stripe.com/api/issuing/cardholders/object.md), utilisez l’[API Cardholders](https://docs.stripe.com/api/issuing/cardholders/create.md) et fournissez les informations requises. L’utilisation de [portefeuilles électroniques](https://docs.stripe.com/issuing/cards/digital-wallets.md) nécessite un numéro de téléphone et une adresse e-mail valides, mais ces informations sont facultatives pour les cartes physiques.

> En tant que plateforme Connect, vous effectuez des appels à l’API au nom de vos comptes connectés en incluant l’ID du compte connecté dans l’en-tête `Stripe-Account`.

| Champ                       | Paramètre      | Description                                                                                                                                                                                                                                                                                                             |
| --------------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Informations de facturation | `billing`      | L’adresse de facturation du titulaire de la carte (généralement l’adresse principale de l’entreprise). Vous ne pouvez pas utiliser une boîte postale, une boîte « highway contract »ou une adresse de boîte aux lettres privée (en revanche, vous pouvez les utiliser comme adresse de livraison des cartes). |
| Type                        | `type`         | Indique si le titulaire de la carte est de type `company` ou `individual`. Consultez la page [Choisir un type de titulaire de carte](https://docs.stripe.com/issuing/other/choose-cardholder.md) pour obtenir des conseils. for guidance.                                                                               |
| Numéro de téléphone         | `phone_number` | Obligatoire pour les portefeuilles numériques                                                                                                                                                                                                                                                                           |
| E-mail                      | `email`        | Adresse e-mail du titulaire de la carte. Obligatoire pour les portefeuilles numériques                                                                                                                                                                                                                                  |

```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]=510 Townsend Street" \
  -d "billing[address][city]=San Francsico" \
  -d "billing[address][state]=CA" \
  -d "billing[address][postal_code]=94111" \
  -d "billing[address][country]=US"
```

Stripe renvoie un objet Cardholder qui contient les informations que vous avez fournies et envoie l’événement [webhook](https://docs.stripe.com/webhooks.md) `issuing_cardholder.created`.

Après avoir créé un objet `Cardholder`, appelez l’endpoint de [modification de titulaire de carte](https://docs.stripe.com/api/issuing/cardholders/update.md) en précisant les paramètres à modifier. Un objet `Cardholder` mis à jour est renvoyé à la réussite de l’appel.

Les titulaires de carte ont un [état](https://docs.stripe.com/api/issuing/cardholders/update.md#update_issuing_cardholder-status) `active` par défaut, ce qui signifie qu’une plateforme a décidé d’activer un titulaire de carte afin que toutes les cartes qui y sont associées puissent approuver les autorisations.

En vertu des dispositions légales et réglementaires applicables, Stripe est tenu de contrôler l’identité des titulaires de carte. Les autorisations peuvent donc être bloquées en fonction des attributs des titulaires de carte, même si leur état est `active`. En savoir plus sur la [vérification des listes de surveillance](https://support.stripe.com/questions/issuing-watchlist-reviews).

Vous pouvez modifier le `status` et le rendre `inactive` en mettant à jour le titulaire de carte. Un état inactive sur un titulaire de carte signifie que toutes les autorisations seront refusées pour toutes les cartes associées avec la raison `cardholder_inactive`.

## Créer des cartes

Après avoir créé un `Cardholder`, émettez une carte pour ce titulaire à l’aide de l’[API Cards](https://docs.stripe.com/api/issuing/cards/create.md).

Un objet [Card](https://docs.stripe.com/api/issuing/cards/object.md) représente une [carte physique](https://docs.stripe.com/issuing/cards/physical.md) ou [virtuelle](https://docs.stripe.com/issuing/cards/virtual.md). Pour créer une carte physique, vous devrez préciser une adresse de livraison. Vous pouvez également fournir des [arguments supplémentaires](https://docs.stripe.com/issuing/cards/physical.md) pour préciser l’emballage et le service de livraison souhaités.

| Titulaire de la carte | `cardholder` | ID du titulaire de carte                                                                                                                                                   |
| --------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Devise                | `currency`   | Code ISO à trois lettres de la devise, en minuscules. Les devises prises en charge sont `usd` aux États-Unis, `gbp` au Royaume-Uni et `eur` dans les pays de la zone euro. |
| Type                  | `type`       | Peut être `physical` ou `virtual`                                                                                                                                          |

L’appel suivant illustre une émission de carte virtuelle associée au titulaire de carte spécifié&nbsp;:

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

Stripe renvoie un objet `Card` lors de la création et envoie l’événement [webhook](https://docs.stripe.com/webhooks.md) `issuing_card.created`.

## Activer des cartes

Pour que des [autorisations](https://docs.stripe.com/issuing/purchases/authorizations.md) soient approuvées, les cartes doivent d’abord être activées.

Si vous n’indiquez pas d’état lors de la création de la carte, celle-ci sera par défaut à l’état `inactive`. Une carte reste `inactive` tant que son état n’a pas été modifié via l’endpoint de [modification de carte](https://docs.stripe.com/api/issuing/cards/update.md).

Pour activer une carte&nbsp;:

```curl
curl https://api.stripe.com/v1/issuing/cards/{{CARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d status=active
```

## Désactiver les cartes

Vous pouvez désactiver les cartes en assignant au paramètre `status` la valeur `inactive` à l’aide de l’endpoint de [modification de carte](https://docs.stripe.com/api/issuing/cards/update.md). Cela signifie que vous ne pouvez pas approuver de *nouvelles* autorisations pour cette carte, mais vous pouvez toujours approuver les autorisations qui ont été ouvertes sur la carte avant que son état ne passe à `inactive`. Pour approuver de nouvelles autorisations, vous devez faire passer l’état de la carte à `active`.

```curl
curl https://api.stripe.com/v1/issuing/cards/{{CARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d status=inactive
```

En savoir plus sur la [gestion des autorisations](https://docs.stripe.com/issuing/purchases/authorizations.md).

## Annuler des cartes

Vous pouvez annuler une carte en la faisant passer à l’état `canceled` (annulée) à l’aide de l’endpoint de [modification de carte](https://docs.stripe.com/api/issuing/cards/update.md). L’annulation d’une carte est irréversible. Si une carte est à l’état `canceled`, vous ne pourrez pas approuver de nouvelles autorisations pour cette carte, mais vous pourrez approuver les autorisations qui ont été ouvertes sur la carte avant que son état ne passe à `canceled`.

```curl
curl https://api.stripe.com/v1/issuing/cards/{{CARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d status=canceled
```

### Lister les titulaires de carte

Vous pouvez consulter les titulaires de carte associés à un compte connecté en envoyant une requête GET à l’[API Cardholders](https://docs.stripe.com/api/issuing/cards/list.md) et en indiquant le `Stripe-Account` concerné dans l’en-tête.

```curl
curl https://api.stripe.com/v1/issuing/cardholders \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}"
```

Sauf échec de l’opération, la réponse renvoie la liste des titulaires de carte&nbsp;:

```json
{
  "object": "list",
  "data": [
    {
      "id": "{{CARDHOLDER_ID}}",
      "object": "issuing.cardholder",
      "billing": {
        "address": {
          "city": "San Francisco",
          "country": "US",
          "line1": "510 Townsend Street",
          "line2": null,
          "postal_code": "94111",
          "state": "CA"
        }
      },
      "company": null,
      "created": 1657144326,
      "email": "jenny.rosen@example.com",
      "individual": null,
      "livemode": false,
      "metadata": {},
      "name": "Jenny Rosen",
      "phone_number": "+18008675309",
      "requirements": {
        "disabled_reason": null,
        "past_due": []
      },
      "spending_controls": {
        "allowed_categories": [],
        "blocked_categories": [],
        "spending_limits": [],
        "spending_limits_currency": null
      },
      "status": "active",
      "type": "individual"
    },
    {
      "id": "{{CARDHOLDER_ID}}",
      "object": "issuing.cardholder",
      "billing": {
        "address": {
          "city": "San Francisco",
          "country": "US",
          "line1": "510 Townsend Street",
          "line2": null,
          "postal_code": "94111",
          "state": "CA"
        }
      },
      "company": null,
      "created": 1656537695,
      "email": "jenny.rosen@example.com",
      "individual": null,
      "livemode": false,
      "metadata": {},
      "name": "Jenny Rosen",
      "phone_number": "+18008675309",
      "requirements": {
        "disabled_reason": null,
        "past_due": []
      },
      "spending_controls": {
        "allowed_categories": [],
        "blocked_categories": [],
        "spending_limits": [],
        "spending_limits_currency": null
      },
      "status": "active",
      "type": "individual"
    }
  ],
  "has_more": false,
  "url": "/v1/issuing/cardholders"
}
```

## Lister les cartes

Vous pouvez également afficher la liste des cartes créées sur un compte connecté en envoyant une requête GET à l’[API Cards](https://docs.stripe.com/api/issuing/cards/list.md) et en indiquant le `Stripe-Account` concerné dans l’en-tête.

```curl
curl https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}"
```

Sauf échec de l’opération, la réponse renvoie la liste des cartes&nbsp;:

```json
{
  "object": "list",
  "data": [
    {
      "id": "{{CARD_ID}}",
      "object": "issuing.card",
      "brand": "Visa",
      "cancellation_reason": null,
      "cardholder": {
        "id": "{{CARDHOLDER_ID}}",
        "object": "issuing.cardholder",
        "billing": {
          "address": {
            "city": "San Francisco",
            "country": "US",
            "line1": "510 Townsend Street",
            "line2": null,
            "postal_code": "94111",
            "state": "CA"
          }
        },
        "company": null,
        "created": 1656537695,
        "email": "jenny.rosen@example.com",
        "individual": null,
        "livemode": false,
        "metadata": {},
        "name": "Jenny Rosen",
        "phone_number": "+18008675309",
        "requirements": {
          "disabled_reason": null,
          "past_due": []
        },
        "spending_controls": {
          "allowed_categories": [],
          "blocked_categories": [],
          "spending_limits": [],
          "spending_limits_currency": null
        },
        "status": "active",
        "type": "individual"
      },
      "created": 1656537950,
      "currency": "usd",
      "exp_month": 5,
      "exp_year": 2025,
      "last4": "0021",
      "livemode": false,
      "metadata": {},
      "pin": null,
      "replaced_by": null,
      "replacement_for": null,
      "replacement_reason": null,
      "shipping": null,
      "spending_controls": {
        "allowed_categories": [
          "car_rental_agencies"
        ],
        "blocked_categories": null,
        "spending_limits": [
          {
            "amount": 8000,
            "categories": [],
            "interval": "per_authorization"
          }
        ],
        "spending_limits_currency": "usd"
      },
      "status": "active",
      "type": "virtual",
      "wallets": {
        "apple_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "google_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "primary_account_identifier": null
      }
    },
    {
      "id": "{{CARD_ID}}",
      "object": "issuing.card",
      "brand": "Visa",
      "cancellation_reason": null,
      "cardholder": {
        "id": "{{CARDHOLDER_ID}}",
        "object": "issuing.cardholder",
        "billing": {
          "address": {
            "city": "San Francisco",
            "country": "US",
            "line1": "510 Townsend Street",
            "line2": null,
            "postal_code": "94111",
            "state": "CA"
          }
        },
        "company": null,
        "created": 1656537695,
        "email": "jenny.rosen@example.com",
        "individual": null,
        "livemode": false,
        "metadata": {},
        "name": "Jenny Rosen",
        "phone_number": "+18008675309",
        "requirements": {
          "disabled_reason": null,
          "past_due": []
        },
        "spending_controls": {
          "allowed_categories": [],
          "blocked_categories": [],
          "spending_limits": [],
          "spending_limits_currency": null
        },
        "status": "active",
        "type": "individual"
      },
      "created": 1656537947,
      "currency": "usd",
      "exp_month": 5,
      "exp_year": 2025,
      "last4": "0013",
      "livemode": false,
      "metadata": {},
      "pin": null,
      "replaced_by": null,
      "replacement_for": null,
      "replacement_reason": null,
      "shipping": null,
      "spending_controls": {
        "allowed_categories": null,
        "blocked_categories": null,
        "spending_limits": [
          {
            "amount": 50000,
            "categories": [],
            "interval": "daily"
          }
        ],
        "spending_limits_currency": "usd"
      },
      "status": "active",
      "type": "virtual",
      "wallets": {
        "apple_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "google_pay": {
          "eligible": true,
          "ineligible_reason": null
        },
        "primary_account_identifier": null
      }
    }
  ],
  "has_more": false,
  "url": "/v1/issuing/cards"
}
```

Vous pouvez consulter la liste des cartes associées à un titulaire de carte spécifique en incluant le paramètre `cardholder` dans votre requête GET à l’[API Cards](https://docs.stripe.com/api/issuing/cards/list.md). Précisez le `Stripe-Account` concerné dans l’en-tête et l’ID du titulaire de la carte dans le paramètre `cardholder`.

```curl
curl -G https://api.stripe.com/v1/issuing/cards \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \
  -d "cardholder={{ISSUINGCARDHOLDER_ID}}"
```