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

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.

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.

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.

const receivedCredit = await stripe.testHelpers.treasury.receivedCredits.create(
  {
    amount: 50000,
    currency: "usd",
    financial_account: 
"{{FINANCIAL_ACCOUNT_ID}}",
    network: "ach",
  },
  { stripeAccount: 
"{{CONNECTED_ACCOUNT_ID}}" }
);

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 to /v1/treasury/outbound_payments. La réponse doit indiquer que l’état des paiements indique processing.

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 posted.

const outboundPayment = await stripe.testHelpers.treasury.outboundPayments.post(
  
'{{OUTBOUND_PAYMENT_ID}}',
);

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 :

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.

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}}.