Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compteConnectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Ressources pour les développeurs
API et SDKAide
Aperçu
Démarrer une intégration
    Application test
    Présentation du processus d'inscription
    Guides d'intégration
Utilisation pour votre entreprise
Comptes financiers
Cartes bancairesConversion instantanée de devises
Global Payouts
Capital
Intégrez-le à votre plateforme
Comptes financiers pour plateformes
Émission de cartes
Capital pour les plateformes
États-Unis
Français (France)
AccueilGestion de fondsStart an integration

Exemple d'application Issuing et de Financial Accounts pour les plateformes

Découvrez comment inscrire des clients, émettre des cartes et effectuer des paiements sortants.

GitHub

Vous trouverez le code source complet de l’application sur GitHub.

Essayez notre application de test pour découvrir comment utiliser les API Issuing et Financial Accounts pour plateformes dans votre intégration. Elle vous permet de vous inscrire en tant que client, de créer des cartes, de tester des autorisations et d’effectuer des paiements sortants depuis un compte financier.

Sans écrire de code, vous pouvez également copier l’application test à utiliser avec votre plateforme, en suivant les logs API générés par vos actions.

Essayer notre application test

Démonstration de page des détails de carte de l’application Issuing et Financial Accounts pour les plateformes

Exemple de page des détails de carte de l’application Issuing et Financial Accounts pour les plateformes

Cette application est destinée aux plateformes qui s’adressent à des clients professionnels. Si vous avez uniquement besoin de cartes pour vous ou vos employés, utilisez Issuing dans le Dashboard.

Créer un compte sur la plateforme

Pour utiliser l’application test, commencez par créer un compte pour vous inscrire en tant que client de la plateforme.

Une fois que vous avez fourni une adresse e-mail et un mot de passe, le back-end de l’application crée un compte connecté et demande les fonctionnalités card_issuing et treasury.

(Facultatif) Simulez un processus d'inscription hébergé pour fournir les détails complets du compte

Pour simuler une inscription hébergée, effectuez les étapes suivantes à l’aide de tokens de test afin d’éviter les erreurs. Nous avons prérempli les données du compte pour cette application.

  1. Décochez la case Ignorer le reste de l’inscription.

  2. Cliquez sur Confirmer dans la boîte de dialogue Données de test.

  3. Cliquez sur Continuer pour être redirigé vers le flux d’inscription hébergée de Stripe.

  4. Sur l’écran Démarrer, saisissez les valeurs suivantes :

    • Numéro de Mobile : 000-000-0000
    • Adresse e-mail : Toute fausse adresse e-mail
  5. Dans Vérifier votre numéro de téléphone portable, cliquez sur Utiliser un code de test.

  6. Sous Vérifier votre identité, cliquez sur Ignorer cette étape.

Une fois le formulaire envoyé, vous êtes redirigé vers le Dashboard de l’application.

Consultez le code et les logs d'API pour ces étapes

Après avoir effectué les étapes d’inscription de votre premier compte dans votre copie de l’application test, consultez les logs API correspondants. Les extraits de code suivants apparaissent dans le back-end lors de l’inscription d’un compte.

  1. Créez un compte connecté avec les fonctionnalités suivantes : transferts, card_issuing, et trésorerie. Issuing prend uniquement en charge les comptes connectés qui n’utilisent pas un Dashboard hébergé par Stripe, et où votre plateforme est responsable du recouvrement des exigences et de la responsabilité des pertes, également connu sous le nom de compte connecté Custom. Découvrez comment créer des comptes connectés compatibles avec Issuing. Copiez notre application pour afficher les logs API, et trouver : POST to /v1/accounts.

    register.ts
    Afficher l'exemple dans son intégralité
    const account = await stripe.accounts.create({ controller: { stripe_dashboard: { type: "none" }, fees: { payer: "application" }, losses: { payments: "application" }, requirement_collection: "application", }, country: "US", email: email, capabilities: { transfers: { requested: true }, treasury: { requested: true }, card_issuing: { requested: true }, }, });
  2. Créez un compte financier. Copiez notre application pour afficher les logs API, et recherchez : POST vers /v1/treasury/financial_accounts.

    register.ts
    Afficher l'exemple dans son intégralité
    const financialAccount = await stripe.treasury.financialAccounts.create( { supported_currencies: ["usd"], features: { card_issuing: { requested: true }, deposit_insurance: { requested: true }, financial_addresses: { aba: { requested: true } }, inbound_transfers: { ach: { requested: true } }, intra_stripe_flows: { requested: true }, outbound_payments: { ach: { requested: true }, us_domestic_wire: { requested: true }, }, outbound_transfers: { ach: { requested: true }, us_domestic_wire: { requested: true }, }, }, }, { stripeAccount: account.id } );
  3. Créez un lien Connect Onboarding et utilisez-le pour rediriger les nouveaux utilisateurs afin de collecter les informations de profil nécessaires pour les fonctionnalités demandées. Copiez notre application pour afficher les logs d’API, puis recherchez : POST to /v1/account_links. La réponse à la requête Account Links inclut une valeur pour l’url utilisée afin de rediriger l’utilisateur vers le flux d’inscription.

    onboarding-helpers.ts
    Afficher l'exemple dans son intégralité
    const { url } = await stripe.accountLinks.create({ type: "account_onboarding", account:
    "{{CONNECTED_ACCOUNT_ID}}"
    , refresh_url: connectOnboardingRedirectUrl + "/onboard", return_url: connectOnboardingRedirectUrl + "/onboard", });
  4. Une fois l’inscription terminée, l’état des fonctionnalités du compte passe de inactive à active. Affichez l’événement account.updated sur le compte connecté à l’adresse https://dashboard.stripe.com/

    '{{CONNECTED_ACCOUNT_ID}}'
    /test/events?type=account.updated. Vous trouverez l’ID du compte connecté dans la réponse à l’étape 1.

Ajouter des fonds au compte financier

  1. Sur la page Aperçu, cliquez sur Générer les données de test, puis, dans le volet, cliquez sur Simuler le crédit reçu.

  2. La transaction apparaît comme un crédit reçu (un ACH entrant) d’un montant de 500 USD et figure dans le reçu de transaction.

  3. Accédez à la page Compte financier pour consulter votre numéro de compte.

Consultez le code et les logs d'API pour ces étapes

Utilisez les exemples de code et les logs d’API suivants pour en savoir plus sur ces étapes.

Outil d’aide au test ReceivedCredit

Dans les environnements de test, vous pouvez ajouter des fonds à un compte financier à l’aide des assistants de test ReceivedCredit. Cet assistant de test simule la réception d’un transfert d’un compte bancaire externe vers votre compte financier. Copiez notre application pour afficher les logs API, et recherchez : POST vers /v1/test_helpers/treasury/received_credits.

create_receivedcredit.ts
Afficher l'exemple dans son intégralité
const receivedCredit = await stripe.testHelpers.treasury.receivedCredits.create( { amount: 50000, currency: "usd", financial_account:
"{{FINANCIAL_ACCOUNT_ID}}"
, network: "ach", }, { stripeAccount:
"{{CONNECTED_ACCOUNT_ID}}"
} );

Effectuer un paiement ACH sortant

Vous pouvez saisir n’importe quel numéro de routage et numéro de compte, mais l’application traite le paiement de test en utilisant les numéros de test de Stripe pour les paiements sortants

  1. Sur la page Compte financier, cliquez sur Envoyer des fonds.
  2. Sélectionnez ACH, puis saisissez les informations du bénéficiaire et le montant à envoyer.
  3. Sélectionnez POSTED comme résultat de la transaction pour simuler un paiement effectué.
  4. La transaction apparaît comme étant un paiement sortant.

Consultez le code et les logs d'API pour ces étapes

Utilisez les exemples de code et les logs d’API suivants pour en savoir plus sur ces étapes.

Interface d’envoi de fonds

La fonctionnalité d’envoi de fonds dans l’application de test utilise la fonctionnalité de Financial Accounts pour les plateformes OutboundPayment. Vous pouvez utiliser OutboundPayments pour envoyer de l’argent vers le compte externe d’un tiers. Copiez notre application pour afficher les logs API, et trouver : POST vers /v1/treasury/outbound_payments. La réponse doit indiquer que l’état des paiements indique en cours de traitement.

send_money.ts
Afficher l'exemple dans son intégralité
const outboundPayment = await stripe.treasury.outboundPayments.create( { financial_account:
"{{FINANCIAL_ACCOUNT_ID}}"
, amount: 100, currency: "usd", statement_descriptor: req.descriptor, destination_payment_method_data: { type: "us_bank_account", us_bank_account: { account_holder_type: "company", routing_number: "110000000", account_number: "000000000009", }, }, }, { stripeAccount:
"{{CONNECTED_ACCOUNT_ID}}"
, } );

Définir le résultat de la transaction avec un assistant de test

Après avoir sélectionné le résultat de la transaction dans l’application Web, l’état des paiements sortants est mis à jour via un endpoint d’assistant de test. Copiez notre application pour afficher les logs API, et recherchez : POST vers /v1/test_helpers/treasury/outbound_payments/{{OUTBOUND_PAYMENT_ID}}/post. La réponse doit indiquer que l’état de paiement indique publié.

send_money.ts
Afficher l'exemple dans son intégralité
const outboundPayment = await stripe.testHelpers.treasury.outboundPayments.post(
'{{OUTBOUND_PAYMENT_ID}}'
, );

Créer un titulaire de carte, une carte et effectuer un achat de test

  1. Sur la page ** Titulaire de carte**, cliquez sur Créer un titulaire de carte.
  2. Saisissez les informations du titulaire de la carte, puis cliquez sur Émettre la carte pour créer une carte virtuelle.
  3. Vous êtes redirigé vers la page Cartes. Cliquez sur Détails sur la ligne de la carte pour afficher la nouvelle carte virtuelle.
  4. Cliquez sur Générer des données de test, puis sur Simuler un achat de test.

Consultez le code et les logs d'API pour ces étapes

Utilisez les exemples de code et les logs d’API suivants pour en savoir plus sur ces étapes.

Créer un titulaire de carte

Créez un Cardholder à l’aide de l’API create cardholder de Stripe Issuing :

cardholders.ts
Afficher l'exemple dans son intégralité
const cardholder = await stripe.issuing.cardholders.create( { type: "individual", name: firstName + " " + lastName, email: email, individual: { first_name: firstName, last_name: lastName, card_issuing: { user_terms_acceptance: { date: Date.now(), ip: ip, }, }, }, billing: { address: { city: city, line1: address1, state: state, postal_code: postalCode, country: country, }, }, }, { stripeAccount:
"{{CONNECTED_ACCOUNT_ID}}"
, } );

Créer une carte

Après avoir créé un Cardholder, vous pouvez émettre une carte pour le Cardholder à l’aide de l’API create card. Définissez le paramètre financial_account de la carte en saisissant la valeur ID du compte financier que vous avez créé à l’étape 2.

index.ts
Afficher l'exemple dans son intégralité
const card = await stripe.issuing.cards.create( { cardholder: cardholderId, financial_account:
'{{FINANCIAL_ACCOUNT_ID}}'
, currency: 'usd', type: 'virtual', status: 'active', }, { stripeAccount:
"{{CONNECTED_ACCOUNT_ID}}"
}, );

Créer un achat de test

Après avoir créé l’autorisation à partir du Dashboard, recherchez le log de l’API : POST to /v1/test_helpers/issuing/authorizations. Une fois l’autorisation capturée dans le Dashboard, recherchez le log de l’API : POST to /v1/test_helpers/issuing/authorizations/{{AUTHORIZATION_ID}}.

FacultatifSuspendre temporairement les dépenses sur une carte

  1. Sur la page Cartes, cliquez sur les Détails d’une carte.
  2. Cliquez sur Désactiver la carte. Sous le bouton, l’état passe à inactive.
  3. Cliquez sur Générer des données de test et suivez le lien pour visualiser la carte depuis le Dashboard.
  4. Dans le Dashboard, cliquez sur Créer un achat de test. Sur la page suivante, l’autorisation est refusée.
  5. Revenez à l’application Web pour afficher les détails de l’autorisation refusée.
  6. Cliquez sur Activer la Carte bancaire pour faire passer l’état de la carte de inactive à active.

Copiez l'application test pour effectuer les étapes 3 à 6

Lorsque vous copiez l’application test et que vous l’utilisez avec vos propres clés API Stripe, vous pouvez créer un achat de test à l’aide de votre Dashboard.

Consultez le code et les logs d'API pour ces étapes

Utilisez les exemples de code et les logs d’API suivants pour en savoir plus sur ces étapes.

Faire passer l’état d’une carte sur inactive

Une fois que vous avez cliqué sur Désactiver, le status de la carte bascule sur inactive. Copiez notre application pour afficher les logs d’API , puis recherchez : POST to /v1/issuing/cards/{{CARD_ID}}.

switch-card-status.ts
Afficher l'exemple dans son intégralité
const card = await stripe.issuing.cards.update(
'{{CARD_ID}}'
, { status: 'inactive', } );

L’autorisation de test a été refusée, car la carte n’était pas active

Après avoir créé l’autorisation à partir du Dashboard, recherchez le log de l’API : POST to /v1/issuing/cards/{{CARD_ID}}/test/authorizations. L’approbation de l’autorisation est définie sur false.

Affichez ensuite l’événement issuing_authorization.created sur le compte connecté à l’adresse https://dashboard.stripe.com/

'{{CONNECTED_ACCOUNT_ID}}'
/test/events?type=issuing_authorization.created. L’autorisation request_history indique 'approved: false, 'reason': 'card_inactive'

FacultatifVirement depuis le solde des paiements du compte vers le compte financier

  1. Sur la page Données de test, cliquez sur Créer un PaymentLink, puis sur Accéder au PaymentLink.

  2. Saisissez l’adresse e-mail, le nom et le code postal de votre choix, et utilisez 4000 0000 0000 0077 comme numéro de carte bancaire.

    • Grâce à cette carte de test, les fonds sont immédiatement ajoutés au solde disponible du compte.
  3. Effectuez le paiement, puis revenez à la page Données de test de l’application Web et actualisez la page.

  4. Sous Créer un Virement, le solde disponible du compte connecté indique 9,41 USD.

  5. Cliquez sur Ajouter un Compte financier en tant que compte externe pour définir le compte externe du compte connecté qui sera utilisé par défaut pour les virements vers le compte financier créé via Financial Accounts pour les plateformes. Pour en savoir plus, consultez la page virements et recharges depuis les paiements de Stripe .

  6. Cliquez sur Créer un virement, puis accédez à la page Aperçu pour afficher les détails de la transaction.

Consultez le code et les logs d'API pour ces étapes

Utilisez les exemples de code et les logs d’API suivants pour en savoir plus sur ces étapes.

Recevoir un paiement

Vous pouvez utiliser des liens de paiement pour recevoir un paiement de test, puis transférer le solde du paiement vers le compte financier associé au compte connecté :

  1. Créez un Price qui détermine le montant versé au compte connecté une fois le paiement effectué.

    create_paymentlinks.ts
    Afficher l'exemple dans son intégralité
    const prices = await stripe.prices.list( { limit: 1, active: true, type: "one_time", }, { stripeAccount:
    "{{CONNECTED_ACCOUNT_ID}}"
    , }, ); const price = prices.data.length < 1 ? await stripe.prices.create( { unit_amount: 1000, currency: "usd", product_data: { name: "Some Product", }, }, { stripeAccount:
    "{{CONNECTED_ACCOUNT_ID}}"
    , }, ) : prices.data[0];
  2. Une fois le tarif obtenu, l’échantillon d’application crée un PaymentLinket redirige l’utilisateur pour qu’il termine le paiement. Utilisez la valeur id du price de l’étape précédente pour définir la valeur du paramètre price. Vous pouvez également exclure le paramètre pour utiliser une valeur par défaut à la place.

    create_paymentlinks.ts
    Afficher l'exemple dans son intégralité
    const paymentLink = await stripe.paymentLinks.create( { line_items: [ { price: price.id, quantity: 1, adjustable_quantity: { enabled: true }, }, ], }, { stripeAccount:
    "{{CONNECTED_ACCOUNT_ID}}"
    , }, );

Virement à partir du solde des paiements du compte connecté

Les virements permettent d’envoyer des fonds depuis le solde des paiements d’un compte connecté vers leur compte financier. Suivez les étapes suivantes pour effectuer un paiement :

  1. Vérifiez si un compte externe est configuré pour le compte connecté. À cet effet, utilisez l’API accounts.retrieve pour obtenir l’objet Account et vérifiez si la propriété external_account est renseignée.

    create_paymentlinks.ts
    Afficher l'exemple dans son intégralité
    const responseAccount = await stripe.accounts.retrieve(
    "{{CONNECTED_ACCOUNT_ID}}"
    ); const hasExternalAccount = responseAccount.external_accounts?.data[0] != undefined;
  2. En l’absence de compte externe existant, l’utilisateur peut configurer le compte financier comme compte externe du compte connecté.

    test-data.tsx
    Afficher l'exemple dans son intégralité
    const financialAccounts = await stripe.treasury.financialAccounts.list( { expand: ["data.financial_addresses.aba.account_number"] }, { stripeAccount:
    "{{CONNECTED_ACCOUNT_ID}}"
    , }, ); const financialAccount = financialAccounts.data[0]; const aba = financialAccount.financial_addresses[0]?.aba; // ... const token = await stripe.tokens.create( { bank_account: { account_number: aba.account_number, country: "US", currency: "usd", routing_number: aba.routing_number, }, }, undefined, ); await stripe.accounts.createExternalAccount(
    "{{CONNECTED_ACCOUNT_ID}}"
    , { external_account: token.id, });
  3. Initiez un virement vers le compte externe du compte connecté. Dans notre cas, le compte externe est le compte financier. Trouver le log API : POST to /v1/payouts.

    create_payout.ts
    Afficher l'exemple dans son intégralité
    const balance = await stripe.balance.retrieve( { stripeAccount:
    "{{CONNECTED_ACCOUNT_ID}}"
    , } ); const payout = await stripe.payouts.create( { amount: balance.available[0].amount, currency: 'usd', }, { stripeAccount:
    "{{CONNECTED_ACCOUNT_ID}}"
    , } );

Affichez l’événement treasury.received_credit.created sur le compte connecté à l’adresse https://dashboard.stripe.com/{{CONNECT_ACCOUNT_ID}}/test/events?type=treasury.received_credit.created. L’ID du compte connecté est indiqué dans la réponse à l’étape 1.

Cette page vous a-t-elle été utile ?
OuiNon
  • Besoin d'aide ? Contactez le service Support.
  • Consultez notre log des modifications.
  • Des questions ? Contactez l'équipe commerciale.
  • LLM ? Lire llms.txt.
  • Propulsé par Markdoc