# Intégrer le modèle Issuing limité aux prestations de services de paiement Configurez une intégration Issuing limitée aux prestations de services de paiement Avant de pouvoir passer au [modèle limité aux prestations de services de paiement](https://docs.stripe.com/issuing/processor-only-issuing.md), vous devez effectuer les procédures Know your customer (KYC) auprès des titulaires de carte. Dans ce modèle, un [objet Cardholder](https://docs.stripe.com/api/issuing/cardholders.md) représente chaque client final. ## Créer un objet Cardholder Créez un objet `Cardholder` pour représenter l’entreprise ou la personne autorisée à utiliser la carte. La réponse comprend un [identifiant](https://docs.stripe.com/api/issuing/cardholders/object.md?lang=ruby#issuing_cardholder_object-id) unique pour le titulaire de la carte. ```curl curl https://api.stripe.com/v1/issuing/cardholders \ -u "<>:" \ -d "name=Jenny Rosen" \ --data-urlencode "email=jenny.rosen@example.com" \ --data-urlencode "phone_number=+18008675309" \ -d status=active \ -d type=individual \ -d "billing[address][line1]=123 Main Street" \ -d "billing[address][city]=San Francisco" \ -d "billing[address][state]=CA" \ -d "billing[address][postal_code]=94111" \ -d "billing[address][country]=US" ``` ## Émettre une carte Émettez la carte au`Cardholder` en transmettant l’identifiant `id` de l’étape précédente. Vous devez également inclure la [devise](https://docs.stripe.com/api/issuing/cards/create.md?lang=ruby#create_issuing_card-currency) et le [type](https://docs.stripe.com/api/issuing/cards/object.md?lang=ruby#issuing_card_object-type) de carte (`physical` ou `virtual`). Dans l’exemple suivant, nous incluons également les informations de [livraison](https://docs.stripe.com/api/issuing/cards/create.md?lang=ruby#create_issuing_card-shipping) du titulaire de la carte. ```curl curl https://api.stripe.com/v1/issuing/cards \ -u "<>:" \ -d currency=usd \ -d type=physical \ -d "cardholder={{ISSUINGCARDHOLDER_ID}}" \ -d "shipping[name]=Jenny Rosen" \ -d "shipping[address][line1]=123 Main St" \ -d "shipping[address][city]=San Francisco" \ -d "shipping[address][state]=CA" \ -d "shipping[address][postal_code]=94111" \ -d "shipping[address][country]=US" ``` ## Suivre la carte Pour suivre l’état de livraison de la carte, utilisez les attributs [tracking_url](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-shipping-tracking_url) ou [tracking_number](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-shipping-tracking_number). Vous pouvez également écouter le webhook `issuing_card.updated` pour suivre les mises à jour de [shipping.status](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-shipping-status). Pour que vous receviez des mises à jour, le transporteur doit prendre en charge le suivi. ## Activer la carte Lorsque vous recevez un webhook indiquant que `shipping.status` est égal à `delivered`, activez la carte en mettant à jour son état. (Vous pouvez également utiliser cette API pour désactiver temporairement la carte.) Par défaut, les cartes sont inactives au moment de leur création. ```curl curl https://api.stripe.com/v1/issuing/cards/{{ISSUINGCARD_ID}} \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d status=active ``` ## Configurer des notifications d’autorisation Configurez le webhook `issuing_authorization.request` pour recevoir immédiatement une notification lorsqu’une demande d’autorisation est effectuée sur une carte émise. Vous pouvez ainsi approuver ou refuser l’autorisation instantanément, ce qui vous permet de décider d’autoriser ou de bloquer une transaction avant qu’elle ne se termine. Pour en savoir plus, consultez la page [Autorisations Issuing en temps réel](https://docs.stripe.com/issuing/controls/real-time-authorizations.md). ## S’abonner aux mises à jour d’autorisation Inscrivez-vous aux événements de webhook `issuing_authorization.create`. Ce webhook vous informe lorsque une personne crée une nouvelle autorisation pour une carte émise. Il fournit des détails sur le résultat de l’autorisation, notamment si elle a été approuvée ou refusée. Vous pouvez ainsi suivre les autorisations, gérer les cas particuliers (par exemple, les refus du réseau après approbation) et bloquer le solde du titulaire de la carte lorsqu’une autorisation est terminée. ## S’abonner aux mises à jour des transactions Inscrivez-vous aux événements de webhook `issuing_transaction.create`. Ce webhook vous informe lorsqu’une nouvelle transaction est créée pour une carte émise, ce qui se produit lorsque Stripe reçoit l’enregistrement de compensation pour une autorisation. Vous ne pouvez pas refuser l’enregistrement de compensation, mais vous pouvez contester la transaction si nécessaire. Utilisez ce webhook pour suivre les dépenses finalisées et mettre à jour les soldes des titulaires de carte en conséquence. Une transaction ne doit pas nécessairement être associée à une autorisation (dans le cas d’une [capture forcée](https://docs.stripe.com/issuing/purchases/transactions.md?issuing-capture-type=force_capture)). En outre, le montant de la transaction ne doit pas nécessairement correspondre au montant d’une autorisation associée (dans le cas d’une [partial_capture](https://docs.stripe.com/issuing/purchases/transactions.md?issuing-capture-type=partial_capture) ou d’une [over_capture](https://docs.stripe.com/issuing/purchases/transactions.md?issuing-capture-type=over_capture)). ## See also - [Reporting](https://docs.stripe.com/stripe-reports.md) - [Litiges](https://docs.stripe.com/issuing/purchases/disputes.md) - [Tokenisation](https://docs.stripe.com/issuing/cards/digital-wallets.md) - [3D Secure (3DS)](https://docs.stripe.com/issuing/3d-secure.md) - [Gestion du programme](https://docs.stripe.com/issuing/program-management.md)