Cartes de débit prépayées destinées aux consommateursVersion bêta privée

Apprenez à émettre des cartes de débit prépayées.

Émettez des cartes de débit prépayées pour permettre à vos utilisateurs de recevoir et de dépenser instantanément de l’argent. Proposez des récompenses, versez des gains ou lancez un programme de cartes bancaires avec le logo de votre marque. Avec les cartes de débit prépayées destinées aux consommateurs, vous pouvez :

Créez des comptes consommateurs et associez-y des cartes bancaires tout en externalisant les obligations KYC et la gestion du registre à Stripe.
Proposez des cartes virtuelles avec provisionnement push vers des wallets, ou des cartes bancaires physiques dont la production et l’expédition sont gérées par Stripe.
Externalisez les litiges, les plaintes et les autres demandes spécialisées du service de support client à Stripe.

Pour les plateformes éligibles, Stripe propose une part des revenus sur les commissions d’interchange des cartes de débit prépayées.

Cas d’usage

Cas d’usage	Description
Récompenses	Envoyez à vos clients des cartes de récompenses prépayées, personnalisées avec le logo de votre entreprise.
Décaissements	Envoyez immédiatement de l’argent pour des indemnisations d’assurance, des remises ou des gains.
Cartes avec le logo de votre marque	Lancez un wallet et une carte avec le logo de votre marque.

Démarrer

Pour établir votre programme Consumer Issuing, vous devez :

Créez et financez un compte financier pour votre plateforme.
Créez des comptes connectés et des titulaires de la carte pour représenter vos clients.
Créez des cartes bancaires rattachées au compte financier du titulaire de la carte.
Financez le compte financier du titulaire de la carte à partir du compte financier de votre plateforme.

Si vous souhaitez bénéficier d’un accès anticipé aux cartes de débit prépayées destinées aux consommateurs, contactez notre équipe.

Créez et alimentez votre Financial Account v2

Utilisez votre Financial Account v2 pour verser des fonds sur le solde de votre consommateur. Un Financial Account v2 est distinct de votre solde de paiements. Si vous avez accès aux cartes de débit prépayées destinées aux consommateurs, nous créons automatiquement un Financial Account v2 pour vous.

Pour financer le compte financier v2, suivez les étapes ci-dessous.

Récupérer l’ID de votre compte financier

Récupérez votre compte financier v2 afin d’obtenir son identifiant pour les requêtes API ultérieures.

Command Line
curl https://api.stripe.com/v2/money_management/financial_accounts \
  -H "Authorization: Bearer $STRIPE_SECRET_KEY" \
  -H "Stripe-Version: 2026-02-25.preview"

Créez une adresse financière v2

Pour créer des identifiants de financement, créez un v2 FinancialAddress.

Command Line
curl -X POST https://api.stripe.com/v2/money_management/financial_addresses \
  -H "Authorization: Bearer $STRIPE_SECRET_KEY" \
  -H "Stripe-Version: 2026-01-28.preview" \
  --json '{
    "financial_account": "{{FINANCIAL_ACCOUNT_ID}}",
    "type": "us_bank_account"
  }'

Récupérer les identifiants de financement

Cette requête renvoie un numéro de routage et un numéro de compte. Utilisez le numéro d’acheminement et le numéro de compte pour initier le financement depuis votre compte bancaire externe.

Command Line
curl -G https://api.stripe.com/v2/money_management/financial_addresses \
  -H "Authorization: Bearer $STRIPE_SECRET_KEY" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -d "include[0]"="credentials.us_bank_account.account_number"

Récupérer le solde de votre compte financier

Selon la source que vous utilisez pour financer votre compte financier, il peut falloir un jour ouvrable pour que les fonds soient disponibles. Utilisez l’API Financial Accounts pour consulter votre solde disponible.

Command Line
curl https://api.stripe.com/v2/money_management/financial_accounts/{{FINANCIAL_ACCOUNT_ID}} \
  -H "Authorization: Bearer $STRIPE_SECRET_KEY" \
  -H "Stripe-Version: 2026-01-28.preview"

Exemple de réponse :

{
  "id": "fa_65NvTFNdpXXUx1kx1rB16NoTesLDSQ1IgNPigisRKq09iq",
  "object": "v2.money_management.financial_account",
  "balance": {
    "available": {
      "usd": {
        "value": 0,
        "currency": "usd"
      }
    },
    "inbound_pending": {
      "usd": {
        "value": 0,
        "currency": "usd"
      }
    },
    "outbound_pending": {
      "usd": {
        "value": 0,
        "currency": "usd"
      }
    }
  }
}

Onboarding des consommateurs

Intégrez chaque consommateur en créant un compte connecté pour lui. Créez un compte pour chaque consommateur souhaitant une carte de débit prépayée sur votre plateforme, que nous appelons un compte connecté. Le compte connecté stocke les informations know your customer (KYC) du consommateur et permet d’activer des fonctionnalités sur le compte. Demandez les capacités storage, card_creator et recipient pour chaque consommateur.

Remarque

Le flux d’onboarding utilise l’API Stripe Accounts v2. Certaines pages de documentation font référence aux objets v1 pour la rétrocompatibilité, mais pour les comptes v1 existants, Stripe fournit des projections pour créer des configurations de compte consommateur.

Créer un Account

Créez un objet Account pour votre consommateur. Utilisez l’identifiant de compte obtenu dans les appels à l’API ultérieurs.

Command Line
curl -X POST https://api.stripe.com/v2/core/accounts \
-H "Authorization: Bearer $STRIPE_SECRET_KEY" \
-H "Stripe-Version: 2026-03-25.preview" \
--json '{
  "configuration": {
    "storer": {
      "capabilities": {
        "consumer": {
          "holds_currencies": {
            "usd": {
              "requested": true
            },
          }
        },
        "outbound_transfers": {
          "bank_accounts": {
            "requested": true
          }
        }
      },
    },
    "card_creator": {
      "capabilities": {
        "consumer": {
          "lead": {
            "prepaid_card": {
              "requested": true
            }
          }
        }
      }
    },
    "recipient": {
      "capabilities": {
        "stripe_balance": {
          "stripe_transfers": {
            "requested": true
          }
        }
      }
    }
  },
  "contact_email": "jenny.rosen@example.com",
  "dashboard": "none",
  "defaults": {
    "currency": "usd",
    "profile": {
      "business_url": "https://accessible.stripe.com"
    },
    "responsibilities": {
      "fees_collector": "application",
      "losses_collector": "application"
    }
  },
  "display_name": "Third J",
  "identity": {
    "country": "US",
    "entity_type": "individual",
    "individual": {
      "email": "jenny.rosen@example.com",
      "given_name": "Jenny",
      "surname": "Rosen",
      "date_of_birth": {
        "day": 1,
        "month": 1,
        "year": 1901
      },
      "phone": "+15555550100",
      "address": {
        "line1": "1234 Main Street",
        "city": "San Francisco",
        "state": "CA",
        "postal_code": "94111",
        "country": "US"
      },
      "id_numbers": [
        {
          "type": "us_ssn",
          "value": "000000000"
        }
      ]
    },
 "include": [
    "configuration.card_creator",
    "configuration.recipient"
  ]
}'

Enregistrement des conditions d’utilisation du service

Présentez les conditions d’utilisation du service au consommateur. Recueillez son acceptation, puis enregistrez-la à l’aide du paramètre attestations dans l’API Accounts v2.

Command Line
curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTED_ACCOUNT_ID}} \
-H "Authorization: Bearer $STRIPE_SECRET_KEY" \
-H "Stripe-Version: 2026-03-25.preview" \
--json '{
  "identity": {
    "country": "US",
    "entity_type": "individual",
    "individual": {
      "email": "jenny.rosen@example.com",
      "given_name": "Corgi",
      "surname": "Cannon",
      "date_of_birth": {
        "day": 1,
        "month": 1,
        "year": 1901
      }
    },
    "attestations": {
      "terms_of_service": {
        "account": {
          "date": "2026-02-20T00:00:00.000Z",
          "ip": "8.8.8.8",
          "user_agent": "Mozilla/5.0"
        },
        "card_creator": {
          "consumer": {
            "account_holder": {
              "date": "2026-02-20T00:00:00.000Z",
              "ip": "8.8.8.8"
            },
            "lead": {
              "prepaid_card": {
                "bank_terms": {
                  "date": "2026-02-20T00:00:00.000Z",
                  "ip": "8.8.8.8"
                },
                "platform": {
                  "date": "2026-02-20T00:00:00.000Z",
                  "ip": "8.8.8.8"
                },
                "financing_disclosures": {
                  "date": "2026-02-20T00:00:00.000Z",
                  "ip": "8.8.8.8"
                }
              }
            }
          }
        }
      }
    }
  }
}'

Attachez l’identifiant du programme d’émission au compte

Récupérez l’identifiant du programme d’émission utilisé par le compte connecté.

Command Line
curl https://api.stripe.com/v1/issuing/programs \
  -H "Authorization: Bearer $STRIPE_SECRET_KEY" \
  -H "Stripe-Version: 2026-01-28.preview;issuing_program_beta=v2"

Associez l’identifiant du programme d’émission au compte connecté.

Command Line
curl https://api.stripe.com/v1/issuing/programs \
  -H "Authorization: Bearer $STRIPE_SECRET_KEY" \
  -H "Stripe-Version: 2026-01-28.preview; issuing_program_beta=v2" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
  -d platform_program={{ISSUING_PROGRAM_ID}} \
  -d is_default=true

Créez un compte financier v2

Créez un compte financier v2 pour le compte connecté afin de stocker le solde associé à sa carte bancaire. Définissez funds_usage_type sur consumer et transmettez l’identifiant du compte connecté dans l’en-tête Stripe-Context.

Command Line
curl "$STRIPE_API_BASE/v2/money_management/financial_accounts" \
  -u "$SK:" \
  -H "Content-Type: application/json" \
  -H "Stripe-Version: 2025-12-15.preview" \
  -H "Stripe-Context: $CA_ID" \
  --json '{
    "type": "storage",
    "storage": {
      "holds_currencies": ["usd"],
      "funds_usage_type": "consumer"
    },
    "display_name": "Consumer Wallet"
  }'

Fermez le compte

Fermez le compte pour supprimer l’accès au compte et aux ressources associées. Transmettez toutes les configurations du compte pour que cette requête réussisse.

Command Line
curl -X POST https://api.stripe.com/v2/core/accounts/{{CONNECTED_ACCOUNT_ID}}/close \
  -H "Authorization: Bearer $STRIPE_SECRET_KEY" \
  -H "Stripe-Version: 2026-01-28.preview; issuing_program_beta=v2" \
  --json '{
    "applied_configurations": [
      "card_creator",
      "recipient"
    ]
  }'

Gérer les exceptions d’onboarding

Si un consommateur ne peut pas finaliser l’onboarding, nous vous en informons via des événements webhook. Utilisez ces événements pour résoudre les exigences et informer votre équipe de support client.

Émission de cartes

Après avoir créé un compte et accordé une récompense au consommateur, émettez une carte bancaire.

La vérification KYC s’effectue de manière asynchrone et peut prendre quelques minutes.

Lorsque vous créez un compte connecté, Stripe effectue la vérification KYC en arrière-plan. Les fonctionnalités requises, par exemple card_creator, ne sont pas activées immédiatement. L’appel des API de création de titulaires de carte (POST /v1/issuing/cardholders) ou d’émission de cartes (POST /v1/issuing/cards) avant l’activation complète des fonctionnalités concernées sur le compte connecté peut entraîner une erreur.

Pour savoir quand une fonctionnalité est active, attendez l’événement webhook v2.core.account[configuration.card_creator].capability_status_updated avant de continuer.

Avertissement

Si vous devez réessayer après l’activation de la fonctionnalité, vous devez utiliser une nouvelle clé d’idempotence. L’API Stripe v1 met en cache les réponses d’erreur associées à la clé d’idempotence d’origine pendant au moins 24 heures. Si vous réessayez avec la même clé pendant ce délai, la même erreur mise en cache est renvoyée, même si la fonctionnalité a été activée. En savoir plus sur la gestion avancée des erreurs.

Créez un titulaire de carte bancaire

Tout d’abord, créez un titulaire de carte. L’objet Cardholder vous permet d’associer plusieurs titulaires de carte à un même compte (par exemple, un titulaire principal et un titulaire secondaire).

Command Line
curl "https://api.stripe.com/v1/issuing/cardholders" \
  -H "Authorization: Bearer $STRIPE_SECRET_KEY" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
  -d "type=individual" \
  -d "name=Jenny Rosen" \
  --data-urlencode "email=jenny.rosen@example.com" \
  -d "status=active" \
  -d "billing[address][line1]=1234 Main Street" \
  -d "billing[address][city]=San Francisco" \
  -d "billing[address][state]=CA" \
  -d "billing[address][country]=US" \
  -d "billing[address][postal_code]=94111" \
  -d "individual[first_name]=Jenny" \
  -d "individual[last_name]=Rosen" \
  -d "individual[dob][day]=1" \
  -d "individual[dob][month]=1" \
  -d "individual[dob][year]=2000" \
  -d "spending_controls[spending_limits][0][amount]=100000" \
  -d "spending_controls[spending_limits][0][interval]=daily"

Émettre une carte bancaire

Émettez la carte bancaire et précisez la devise. Associez le compte financier v2 du consommateur à la carte bancaire.

Command Line
curl "https://api.stripe.com/v1/issuing/cards" \
-H "Authorization: Bearer $STRIPE_SECRET_KEY" \
-H "Stripe-Version: 2026-01-28.preview" \
-H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
-d "cardholder={{CARDHOLDER_ID}}" \
-d "financial_account_v2={{CONSUMER_FINANCIAL_ACCOUNT_ID}}" \
-d "currency=usd" \
-d "type=virtual"

Activez la carte bancaire

Les cartes sont inactives par défaut lorsque Stripe les crée. Pour activer la carte bancaire :

Command Line
curl "https://api.stripe.com/v1/issuing/cards/{{CARD_ID}}" \
-H "Authorization: Bearer $STRIPE_SECRET_KEY" \
-H "Stripe-Version: 2026-01-28.preview" \
-H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \
-d status=active

Financement de la carte bancaire

Utilisez v2 Outbound Payments pour transférer des fonds du compte financier de la plateforme vers le compte financier du compte connecté. Les fonds présents sur le compte financier du compte connecté alimentent l’activité de la carte. Si le compte financier du compte connecté ne dispose pas de fonds suffisants, les autorisations sont refusées.

Vous pouvez financer ce compte à tout moment, y compris avant de créer la carte bancaire.

Command Line
curl -X POST https://api.stripe.com/v2/money_management/outbound_payments \
  -H "Authorization: Bearer $STRIPE_SECRET_KEY" \
  -H "Stripe-Version: 2026-01-28.preview" \
  --json '{
    "amount": {
      "value": 100,
      "currency": "usd"
    },
    "from": {
      "currency": "usd",
      "financial_account": "{{PLATFORM_FINANCIAL_ACCOUNT_ID}}"
    },
    "to": {
      "currency": "usd",
      "payout_method": "{{CONSUMER_FINANCIAL_ACCOUNT_ID}}",
      "recipient": "{{CONNECTED_ACCOUNT_ID}}"
    }
  }'

Wallets

Stripe propose des services de tokenisation pour les principaux fournisseurs de wallets et peut vous aider à activer le provisionnement manuel ou le provisionnement push dans l’application. Utilisez les guides suivants pour démarrer :

Stripe Elements

Vous pouvez afficher les informations de carte bancaire pour une carte virtuelle à l’aide de Stripe Issuing Elements. Cette implémentation basée sur JavaScript et iframe vous permet d’afficher des informations sensibles de carte dans votre interface utilisateur existante avec un bouton Copier.

Numéro de carte, également appelé PAN (cartes virtuelles uniquement)
CVC (cartes virtuelles uniquement)
Date d’expiration
PIN

Vérifiez le solde du consommateur

Vous pouvez vérifier le solde du consommateur à l’aide de son identifiant de compte financier.

Command Line
curl $STRIPE_API_BASE/v2/money_management/financial_accounts/{{FINANCIAL_ACCOUNT_ID}} \
  -u "$SK:" \
  -H "Stripe-Context: $CA_ID" \
  -H "Stripe-Version: 2025-12-15.preview"

De plus, vous pouvez lister les transactions du consommateur :

Command Line
curl -G $STRIPE_API_BASE/v2/money_management/transactions \
    -u "$SK:" \
    -H "Stripe-Context: $CA_ID" \
    -H "Stripe-Version: 2026-03-25.preview" \
    -d "financial_account=$FA_ID"

Soumettre des preuves de contestation de paiement

Stripe propose un processus guidé dans le Dashboard ainsi qu’une API pour soumettre des litiges et les suivre jusqu’à leur résolution. Découvrez comment utiliser Issuing pour contester des transactions.

Notifications réglementées destinées aux clients

Stripe envoie automatiquement à vos clients les e-mails exigés par la Reg E à chaque étape du cycle de vie du litige, avec le logo de votre plateforme et son nom. Pour la configuration de l’adaptation à votre marque de la plateforme et des informations sur l’envoi de vos propres e-mails réglementés, consultez Notifications réglementées Issuing destinées aux clients.

Modèles d’e-mail de litige pour les consommateurs

Dispute received

Confirm your dispute in writing (managed support)

Provisional credit applied

No error found — resolution notice

Error found — provisional credit finalized

No error found — written explanation and provisional credit reversal

Résultats de la résolution des litiges

Les e-mails comprenant un champ {{FINDINGS_SUMMARY}} sont remplis par Stripe en fonction du type de litige et du résultat de la vérification. Les résultats suivants s’appliquent lorsqu’aucune erreur n’est détectée :

Unauthorized use or fraud

Processing errors

ATM cash not received

Canceled recurring transaction

Données enrichies sur les commerçants

Vous pouvez améliorer l’historique des transactions de vos utilisateurs en incluant des données enrichies sur les commerçants, telles que des noms de l’entreprise lisibles et des logos standardisés. Vous pouvez également utiliser ces données pour améliorer les contrôles des dépenses en utilisant des identifiants de contrepartie cohérents entre les canaux et les vitrines.