Issuing と Treasury のサンプルアプリ

ホスティング登録をシミュレートする場合、エラーを防止するために、テストトークンを使用して以下のステップを実行します。このアプリのアカウントデータは事前入力されています。

1. Skip the rest of onboarding (残りのアカウント登録をスキップする) のチェックマークを外します。

2. テストデータ ダイアログで確定する をクリックします。

3. 続行をクリックして、Stripe のホスティング登録フローに移動します。

4. Let’s get started (始めましょう) 画面で、以下を入力します。

   • 携帯電話番号: 000-000-0000
   • メールアドレス: 任意の架空のメールアドレス

5. 携帯電話番号を確認する で、テストコードを使用 をクリックします。

6. 本人確認を行う では、この手順をスキップする をクリックします。

フォームを送信すると、アプリのダッシュボードにリダイレクトで戻されます。

サンプルアプリのコピーで最初のアカウントを登録するステップを完了したら、対応する API ログを確認します。アカウント登録時にバックエンドで下記のコードスニペットが実行されます。

1. transfers, card_issuing, treasury のケイパビリティを持つ連結アカウントを作成します。Issuing は、Stripe がホストするダッシュボードを使用せず、プラットフォームが要件の収集と損失に対する責任を負う連結アカウント (Custom 連結アカウントとも呼ばれる) のみをサポートします。詳しくは、Issuing と連携可能な連結アカウントの作成方法をご確認ください。Stripe アプリをコピーして API ログを表示し、POST to /v1/accounts を見つけます。

   register.ts

   サンプル全体を表示

   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. Stripe Treasury の金融口座を作成します。Stripe アプリをコピーして API ログを表示し、POST to /v1/treasury/financial_accounts を見つけます。

   register.ts

   サンプル全体を表示

   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. Connect アカウント登録リンクを作成し、そのリンクを使用して新規ユーザーをリダイレクトして、リクエストされたケイパビリティに必要なプロフィール情報を収集します。Stripe アプリをコピーして API ログを表示し、POST to /v1/account_links を見つけます。Account Links リクエストのレスポンスには、アカウント登録フローへのリダイレクトに使用される url の値が含まれています。

   onboarding-helpers.ts

   サンプル全体を表示

   const { url } = await stripe.accountLinks.create({
     type: "account_onboarding",
     account: 
   '{{CONNECTED_ACCOUNT_ID}}',
     refresh_url: connectOnboardingRedirectUrl + "/onboard",
     return_url: connectOnboardingRedirectUrl + "/onboard",
   });

4. アカウント登録が完了すると、アカウントのケイパビリティの status (ステータス) は inactive から active に変わります。「https://dashboard.stripe.com/

   '{{CONNECTED_ACCOUNT_ID}}'
   /test/events?type=account.updated」で連結アカウントの account.updated イベントを表示します。ステップ 1 のレスポンスで連結アカウントの ID を確認できます。

これらのステップの詳細を確認するには、以下のコードサンプルと API ログを使用します。

ReceivedCredit テストヘルパー

テスト環境では、ReceivedCredit テストヘルパーを使用して Treasury 金融口座に資金を追加できます。このテストヘルパーは、外部の銀行口座から金融口座への送金の受け取りをシミュレーションします。アプリをコピーして API ログを表示し、POST to /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}}' }
);

これらのステップの詳細を確認するには、以下のコードサンプルと API ログを使用します。

送金インターフェイス

サンプルアプリの送金機能は、Stripe Treasury の OutboundPayment 機能を使用しています。OutboundPayments は、サードパーティーの外部口座への送金に使用できます。Stripe アプリをコピーして API ログを表示し、POST to /v1/treasury/outbound_payments を見つけます。レスポンスには、支払いのステータスが 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}}',
  }
);

テストヘルパーを使用して取引結果を設定する

ウェブアプリで取引結果を選択すると、アウトバウンド支払いのステータスは、テストヘルパーのエンドポイントを介して更新されます。Stripe アプリをコピーして API ログを表示し、POST to /v1/test_helpers/treasury/outbound_payments/{{OUTBOUND_PAYMENT_ID}}/post を見つけます。レスポンスには、支払いのステータスが posted であることが表示されます。

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

これらのステップの詳細を確認するには、以下のコードサンプルと API ログを使用します。

カード保有者を作成する

Stripe Issuing の Create Cardholder (カード保有者の作成) API を使用して Cardholder を作成します。

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}}',
  }
);

カードを作成する

Cardholder を作成した後、Create Card (カードの作成) API を使用して Cardholder にカードを発行します。カードの financial_account は、ステップ 2 で作成した金融口座の ID に設定します。

const card = await stripe.issuing.cards.create(
  {
    cardholder: cardholderId,
    financial_account: 
'{{FINANCIAL_ACCOUNT_ID}}',
    currency: 'usd',
    type: 'virtual',
    status: 'active',
  },
  {
    stripeAccount: 
'{{CONNECTED_ACCOUNT_ID}}'
  },
);

テスト購入を作成する

ダッシュボードでオーソリを作成した後に、API ログ POST to /v1/test_helpers/issuing/authorizations を探します。ダッシュボードでオーソリをキャプチャーした後は、API ログ POST to /v1/test_helpers/issuing/authorizations/{{AUTHORIZATION_ID}} を探します。