Fifth Third Bank と連携させる公開プレビュー

Stripe collaborates with multiple bank partners to support its Global Payments and Treasury Network. We’ve added Fifth Third Bank as a new bank partner for Stripe’s Financial Accounts for platforms product.

If you’re already using Financial Accounts for platforms, this guide describes how it works with Fifth Third Bank.

If you’re launching with Financial Accounts for platforms for the first time, see Get started with a new Financial Accounts for platforms integration using Fifth Third Bank.

Financial Accounts for platforms accounts structure

The overall structure of accounts remains unchanged. You can continue using Connect to maintain your existing platform account, along with a connected account for each of your users. Because each connected account represents a user, it’s associated with that user’s KYC and compliance information. As you enable additional Stripe products for each of your connected accounts (such as Payments with additional payment methods, Financial Accounts for platforms, or Issuing), you can reuse that user’s information without needing to re-collect it.

Each connected account can create and maintain one or more financial accounts, each of which represents an FDIC insurance-eligible account. Financial accounts are each created with one bank partner (now including Fifth Third Bank). Each connected account can have up to three total financial accounts across bank partners, unless your platform has been approved for a higher limit. If you have a business reason for a higher limit, contact your sales representative or email us.

それぞれの金融口座は、Connect の支払い残高から資金を受け取ることができ、また、他の金融口座と外部の銀行口座との間で資金を送金することもできます。

Fifth Third の金融口座には、Evolve の金融口座で使用するものと同じ API を使用できます。API の動作は、次のいくつかの重要な違いを除いて同じです。

1. 電信送金または ACH 経由で Fifth Third の金融口座から送金される OutboundTransfers では、Evolve での送金よりも遅いカットオフ時間が使用されます。
2. 支払い残高から送金された Stripe の入金は、外部の銀行口座や Evolve の金融口座への入金よりも早く、Fifth Third の金融口座に入金されます。
3. 新しいケイパビリティ treasury_fifth_third を使用して、連結アカウントの規制順守を管理できます。

Fifth Third Bank を Evolve と同等に構築する間、受領するデビット金額の一時的な制限など、追加の短期的な相違点が発生する可能性があります。

Fifth Third Bank の機能の提供状況

Financial Accounts for platforms supports feature parity across both bank partners.

新規または既存の連結アカウントの Fifth Third Bank へのアクセス権をリクエストする

Use POST /v1/accounts to create a new connected account. To enable the account to use Financial Accounts for platforms, request the following required capabilities for the account:

• transfers (すべての連結アカウントに必要)
• treasury (required for your Financial Accounts for platforms integration)
• treasury_fifth_third (新規、Fifth Third Bank のアクセスに必要)
• Continue to request the same capabilities you currently request.

ケイパビリティをリクエストすると、連結アカウントの Account オブジェクトの requirements.currently_due hash に、ケイパビリティを有効にするために満たす必要のある要件が入力されます。連結アカウントでフィールドがすでに入力されている場合、Stripe は再送信を求めずにそれを再利用します。フィールドの収集には、Stripe 上、埋め込み型、または API のアカウント登録を引き続き使用できます。

If you already have a connected account with Financial Accounts for platforms enabled, use POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} to update the account with the associated ID with a request for the treasury_fifth_third capability.

treasury_fifth_third ケイパビリティのリクエストには、treasury ケイパビリティと比較して新しいフィールドは必要ありません。ただし、Fifth Third Bank にアクセスするには、10 文字以上の URL または商品説明と、アメリカを拠点とするアカウント担当者が必要です。この点が、商品説明の最小文字数要件がない treasury ケイパビリティとは異なります。したがって、連結アカウントが URL を提供しておらず、商品の説明が 10 文字未満の場合は、URL を指定するか、商品の説明を更新して 10 文字以上にする必要があります。

You can always preview the treasury_fifth_third capability on each live connected account to make sure that there are no additional requirements for that account. To reduce the chance of review delays and requests for more detail, provide product descriptions of at least 30 characters.

次のフィールドは、各連結アカウントが Stripe でサポートされていることを確認するのに役立ちます。

1. URL: Provide a URL to ensure the highest chance that your connected account is approved for supportability. Stripe reviews each connected account’s URL to make sure it qualifies as a supportable business. We recognize legitimate cases where a connected account doesn’t have a URL (for example, it isn’t an online business or hasn’t launched a website yet), so a URL isn’t strictly required by the Accounts requirements hash, and we won’t block access to the treasury_fifth_third capability if the connected account can’t provide a URL. However, we expect you to provide a URL if one is available, and we’ll perform manual compliance reviews to make sure that you collect URLs. A URL is already a requirement for the card_payments and us_bank_account_ach_payments capabilities, meaning you might already collect a URL if you request either of these capabilities.

2. Product description: If you don’t submit a URL, we assess the product description field to determine if we can support your connected account, which must be 10 characters or longer. If an existing connected account has no URL and a product description under 10 characters, you must provide a longer description to gain access to Fifth Third. We recommend guiding connected accounts to submit a product description that reflects the purpose of opening a financial account and its intended use, with as much detail as possible. That minimizes the likelihood of restrictions or other issues with the financial account. To reduce the chance of review delays and requests for more detail, provide product descriptions of at least 30 characters.

treasury_fifth_third ケイパビリティと treasury ケイパビリティの両方の要件をすべて満たしたら、連結アカウントを使用して Evolve と Fifth Third Bank で金融口座を作成できます。

1. Account Representative: We validate that your account representative is based in the US when requesting the treasury_fifth_third capability. If we determine that your account representative isn’t based in the US, we might not grant your connected account the capability. See Financial Accounts for platforms requirements for more information.

連結アカウントの Fifth-Sird へのアクセスステータスを確認する

As your connected accounts onboard onto Fifth Third, Stripe will review each connected account to make sure that it’s a supportable use case. Your users might need to provide additional information, such as proof of licenses for their industry. Based on the information they provide, Stripe might not support the account. Learn more about Financial Accounts for platforms supportability reviews.

法令遵守 / 規制プランのエラーコードに対するトラブルシューティング

プラットフォームの連結アカウント用に treasury_fifth_third ケイパビリティをリクエストする際は、URL または商品説明を提供して、Fifth Third Bank が連結アカウントをサポート可能かどうかを確認する必要があります。URL を提供した場合、エラーコードが表示されることがあります。

• invalid_url_format: 提供した URL の形式または文字列が正しくありません。URL を有効な形式 (.com、.org など) に更新してください。
• invalid_url_denylisted: 提供した URL が Stripe の「拒否リスト」に記載されていることを示します。サポートが必要な場合は、お問い合わせください。
• invalid_url_website_inaccessible: 送信した URL はパスワードで保護されている可能性があります。サポートの可否を評価するには、連結アカウントのウェブサイトにアクセスできる必要があります。
• invalid_url_website_incomplete: 提供した URL が 404 ステータスエラーコードを返しています。
• Invalid_url_website_other: Stripe がこのエラーを返した場合は、お問い合わせください。

URL フィールドが引き続きエラーを返す場合、または連結アカウントで修正できない場合は、代わりに商品説明を提供してください。

Fifth Third Bank で金融口座を作成する

FinancialAccount の作成

必要なケイパビリティを有効にした連結アカウントの新しい FinancialAccount を Fifth Third Bank で作成するには、POST /v1/treasury/financial_accounts を使用し、コールの Stripe-Account header の値として連結アカウントの ID を含めます。

金融口座を作成する際に、features[financial_addresses][aba][bank]="fifth_third" を指定して、Evolve で作成されないようにします。金融口座の作成後に銀行パートナーを変更することはできません。

features[financial_addresses][aba][requested]="true" を指定して、外部からアクセス可能な口座番号と金融番号 (financial_addresses.aba) をリクエストします。

連結アカウント用に Fifth Third の金融口座を作成するには、その連結アカウントに残高がマイナスの金融口座がないことを確認します。404 エラーを回避するために、すべての金融口座の残高が 0 USD 以上である必要があります。

You can request the same features on the Fifth Third financial account that you’ve requested on your Evolve financial accounts, including outbound_transfers, outbound_payments, and other features. If you request a financial account Feature that hasn’t been released for Fifth Third Bank yet, Stripe returns the following error: “You cannot request {_feature_} on a financial account with bank fifth_third.”

curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "supported_currencies[]"=usd \
  -d "features[card_issuing][requested]"=true \
  -d "features[deposit_insurance][requested]"=true \
  -d "features[financial_addresses][aba][requested]"=false \
  -d "features[financial_addresses][aba][bank]"=fifth_third \
  -d "features[inbound_transfers][ach][requested]"=true \
  -d "features[intra_stripe_flows][requested]"=true \
  -d "features[outbound_payments][ach][requested]"=true \
  -d "features[outbound_payments][us_domestic_wire][requested]"=true \
  -d "features[outbound_transfers][ach][requested]"=true \
  -d "features[outbound_transfers][us_domestic_wire][requested]"=true

FinancialAccount を更新、取得、解約する

There are no changes to the APIs used to update a financial account, close a financial account, or retrieve a financial account. For more information, see Working with financial accounts.

FinancialAccount Webhook

We support all financial account webhooks, including:

• account.updated
• treasury.financial_account.created
  • FinancialAccount が新規作成されるたびにトリガーされます。
• treasury.financial_account.closed
• treasury.financial_account.features_status_updated
  • 1 つ以上の機能のステータスが変わったことを示します。これを反映して、active_features、pending_features、または restricted_features の配列に変更が加えられます。

Fifth Third の金融口座で資金を移動する

資金移動の概要

Financial Accounts for platforms offers many types of money movement in and out of financial accounts. You can categorize each transaction type in four ways:

• クレジットまたはデビット: クレジットは口座から資金を送金して資産を減らす指示であり、デビットは口座に資金を受け取り資産を増やす指示です。
• 受領または開始: クレジットとデビットのいずれかを金融口座 (受領) または他の当事者の口座 (開始) に適用するかどうかを指定します。たとえば、開始されたクレジットによって金融口座から資金が送金されると残高が減少し、受領したクレジットによって金融口座に入金されると残高が増加します。
• レール: 各タイプの資金移動は、ACH、電信送金、Stripe ネットワーク、小切手、Issuing 取引など、1 つ以上のレールによってサポートされます。
• (任意) 入金または出金: これは必要に応じて、資金を金融口座から出金するか、金融口座に入金するのかを指定する方法です。

Financial Accounts for platforms money movement APIs

The following table describes the available Financial Accounts for platforms money movement APIs.

金融口座の取引を開始する

OutboundTransfer または OutboundPayment でクレジットを開始する

To move funds out of a Fifth Third financial account, you can create an OutboundTransfer to send funds between two accounts with the same owner, or OutboundPayment to send funds between different account holders.

You can transfer funds to another financial account owned by your platform using the Stripe network. Funds arrive within an hour. To send over the Stripe network, you must enter a financial account ID into the destination_payment_method_data field instead of an account and routing number.

または、電信送金または ACH を使用して取引の送信を行うよう Stripe に指示することもできます。公開された期限までに送信すると、電信送金を開始したその日のうちに追跡情報が届きます。国内の電信送金は、送金先銀行と送信時刻に応じて、Stripe の銀行パートナーが FedWire または CHIPS ネットワークを使用して送金する場合があります。Evolve の金融口座から電信送金を開始する場合は、FedWire を使用して送金が行われます。Fifth Third Bank の金融口座から電信送金を開始する場合は、受け取り側の銀行が CHPS を受け付けていて、電信送金が CHIPS の営業時間内に行われる場合に限り、 CHIPS を使用して送金が行われます。それ以外の場合は FedWire を使用して送金が行われます。

Fedwire を使用して送金された電信送金の場合、IMAD および OMAD フィールドは、tracking_details[us_domestic_wire][imad] フィールドおよび tracking_details[us_domestic_wire][omad] フィールド内で確認できます。

CHIPS を使用して送金される電信送金の場合、送金のシステムシーケンス番号は tracking_details[us_domestic_wire][chips] で確認できます。これらの ID を受け取り側の銀行と共有して、電信送金のステータスを追跡できます。

Evolve と比較すると、Fifth Third Bank による送金と ACH の締め切りのタイミングは遅くなります。

締め切りのすぐ後に送金を送信した場合、その日の夜に処理される可能性がありますが、必ずそうなると保証されているわけではありません。

For more information about these APIs, see OutboundTransfers and OutboundPayments.

InboundTransfer でデビットを開始する

You can originate debits using InboundTransfers. InboundTransfers are always originated using ACH and are subject to Originated Transaction submission cutoffs.

Stripe Payouts からの Payouts

If you or your connected accounts use Stripe Payments, you can send acquired funds into your Fifth Third financial account using the standard Payouts APIs. You can continue using your current payout setup, and switch to pay out into Fifth Third financial accounts by following the instructions below.

保留中の売上を早期に利用することなく入金を作成して Fifth Third の金融口座に売上を移動する場合、Evolve の金融口座や外部の銀行口座に比べて入金が速く処理されます。

自動入金スケジュールを設定するか、手動入金のみを作成するかどうかと、保留中の売上に早期アクセスするかどうか決定します。

• 自動または手動: 連結アカウントが売上を入金するための自動入金スケジュールを設定できます (毎日など)。自動入金スケジュールを設定している場合でも、手動入金はいつでも作成できます。自動入金では、Payout オブジェクトに常に reconciliation_status が入力され、対応する payout.reconciliation_completed イベントがトリガーされます。手動入金ではこのようなことは行われません。
• Standard or accelerated access: You can accelerate access to pending card funds to pay out in either a manual or an automatic payout. When you acquire card payment volume, funds typically become available in the balance two business days after funds are received. You can pay to accelerate access, by either creating an instant manual payout (method=instant), or setting a connected account to an accelerated automatic payout schedule (delay_days=1), associated with respective fees. This won’t accelerate access to pending funds from ACH or other payment methods, only cards.

To accelerate access to funds, you must obtain a one-time platform credit risk approval if you haven’t already enabled accelerated or instant payouts with Stripe. Enabling accelerated payouts might increase your platform risk by allowing connected accounts to withdraw funds more quickly. To access this feature for cards or for ACH, contact your sales representative.

入金タイミングの改善

Fifth Third の金融口座に作成した入金は、外部の銀行口座や Evolve の金融口座に送金されたものよりも早く着金します。

手動入金オプション

手動入金では、standard と instant という 2 つのオプションがあります。

• Standard manual payouts: These only include settled payments funds, not pending payments funds. Settled funds are expected to arrive within a few hours, meaning that new card payments arrive in approximately 1-2 days after pay-in capture. This timing is an improvement compared to payouts into Evolve financial accounts or external bank accounts, where settled funds arrive approximately 1 day after the payout request or 2–3 days after pay-in capture. Stripe doesn’t guarantee precise payout timing.

• Instant manual payouts: These draw from both pending and settled funds. When you acquire card payment volume, funds typically become available in the balance two business days after funds are received. Other payment types, such as ACH payments, take longer. Funds are pending until they’re available. When you create an instant manual payout, you can include all funds in the instant_available balance. Instant manual payouts are expected to arrive within a few hours, which is the same behavior for Fifth Third financial accounts as for Evolve financial accounts or external bank accounts.

お使いのプラットフォームで早期入金が有効になっておらず、この機能を追加することにご関心がある場合は、営業担当者にお問い合わせいただくか、treasury-support@stripe.com に当社までお問い合わせください。

自動入金オプション

必要に応じて、各連結アカウントの自動入金スケジュールを設定できます。Stripe は、利用可能になったすべての売上に対して、指定された頻度 (日次など) で入金を作成し、指定された外部の銀行口座 (金融口座など) に売上を送金します。

settings.payouts.schedule で 2 つのパラメータを設定することで、自動入金の速度を制御できます。

• interval: 資金が入金される頻度を定義できます。設定できる値は、daily、weekly、monthly、または manual です。manual に設定すると自動入金が無効になり、代わりに手動入金のみを行うように設定されます。
• delay_days: アメリカを拠点とするビジネスは、標準入金に利用できるようになるまで支払いを保留する営業日ベースの日数を定義できます。デフォルトは 2 日です。日数を長く設定するとリスクを下げることができ、日数を短く設定すると保留中の売上を早期に利用できます。

間隔を毎日に設定し、delay_days=2 に設定すると、売上は入金のキャプチャーから約 1 ～ 2 営業日で入金されます。このタイミングは、入金のキャプチャーから 2 ～ 3 日で入金される Evolve の現行のプロセスよりも改善されています。

間隔を毎日に設定し、delay_days=1 を設定すると、売上が入金キャプチャーから約 1 営業日後に入金されるため、売上を早期に利用できます。営業日以外の入金をご希望の場合は、営業担当者にお問い合わせください。

Use POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} to update the payout schedule.

Fifth Third の金融口座を使用するように入金を更新する

入金用の金融口座を設定する

Before you can send payouts to a financial account or receive top-ups from a financial account, you must set the financial account as an external account (BankAccount object) connected to the relevant Stripe account. You now have the option to set up an external account by specifying the financial account id. You must also request the intra_stripe_flows feature on your Financial Account.

• プラットフォームアカウント: Stripe ダッシュボードを使用して、プラットフォームアカウントからの入金またはプラットフォームアカウントへのトップアップに使用できる BankAccount オブジェクトを作成します。
• 連結アカウント: POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/external_accounts を使用して、financial_account パラメーターに新しい金融口座 id を指定して、連結アカウントからの入金に使用できる BankAccount オブジェクトを作成します。

curl https://api.stripe.com/v1/accounts/acct_xxx/external_accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "external_account[country]"=us \
  -d "external_account[currency]"=usd \
  -d "external_account[financial_account]"=fa_xxx \
  -d "external_account[object]"=bank_account

Stripe は以下を返します。

{
 "id": "ba_xxx",
  ...
}

手動入金を作成する

新しい Fifth Third の金融口座に銀行口座 id を設定したら、POST /v1/payouts を呼び出して、宛先パラメーター値を新しい銀行口座 id として指定します。

curl https://api.stripe.com/v1/payouts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d destination=ba_xxx \
  -d method=instant

自動入金の設定を更新する

If you have connected accounts on your platform with an automatic payout schedule, you can send payouts to their new Fifth Third financial account. Set the default_for_currency parameter to true on the external account you created for the Fifth Third financial account.

入金の差戻し

有効な ABA 機能を持つ金融口座への入金に対して入金の差戻しを作成できます。

金融口座で取引を受け取る

既存の FinancialAccount からクレジットを受け取る

To move funds from an existing financial account into a Fifth Third financial account, create an OutboundTransfer or OutboundPayment from the existing financial account. If you enter a Fifth Third financial account ID in the destination_payment_method_data for an OutboundPayment, the transaction is sent over the Stripe network.

curl https://api.stripe.com/v1/treasury/outbound_transfers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d financial_account=treasuryFinancialAccount \
  -d amount=1000 \
  -d currency=usd \
  -d "destination_payment_method_data[type]"=financial_account \
  -d "destination_payment_method_data[financial_account]"=destinationFifthThirdFinancialAccount \
  -d "destination_payment_method_data[statement_descriptor]"="Test xfer" \
  -d "destination_payment_method_data[description]"="OutboundTransfer to my Fifth Third financial account"

外部ソースからクレジットまたはデビットを受け取る

Fifth Third financial accounts receives externally addressable account and routing numbers (VBAN) after you request and enable the financial_addresses.aba feature. Your connected accounts can share the account and routing numbers for their Fifth Third financial account to received credits (wire and ACH) and received debits (ACH) from external parties. They can also use microdeposits to authenticate with the account.

外部の関係者によっては、電信送金を開始するために銀行の住所を要求される場合があります。Fifth Third の金融口座への電信送金を有効にするには、連結アカウントに次の住所を入力します。

38 Fountain Square Plaza Cincinnati, OH 45263

You can initiate reversals for debits by creating a DebitReversal. You must create a DebitReversal within 24 hours; however, we’ll extend this window in the coming months. Until we support CreditReversals, email Stripe support to reverse a credit. We don’t currently support late reversals.

Fifth Third の金融口座でカードを発行する

Your Issuing integration will remain unchanged, and you won’t need to reissue cards to your users. You’ll have the ability to redirect existing cards from current financial accounts to the new Fifth Third financial accounts without affecting users. This is new functionality, and currently isn’t possible.

既存のカードに更新して、既存の金融口座からの資金移動から新しい Fifth Third の金融口座への資金移動に切り替えることができます。

新しい金融口座 ID でカードを更新することで、カードを移行できます。

curl https://api.stripe.com/v1/issuing/cards/ic_xxx \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d financial_account=fa_xxx

Stripe は以下のレスポンスを返します。

{
  "id": <card Id>,
  "object": "issuing.card",
  "financial_account": <new Financial Account Id>,
  ...
}

カードが別の金融口座にリダイレクトされても、承認は同じ金融口座に関連付けられたままになります。今後のカードイベントは、元の金融口座の残高に影響します。たとえば、支出カテゴリによっては、最大 30 日後に増分オーソリリクエストが発生する可能性があります。

カード作成時に新しい金融口座 ID を指定することにより、Fifth Third 金融口座から引き落とされる新しいカードを発行することもできます。

Fifth Third の金融口座を作成し、card_issuing 機能をリクエストできます。

curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "supported_currencies[]"=usd \
  -d "features[card_issuing][requested]"=true \
  -d "features[deposit_insurance][requested]"=true \
  -d "features[financial_addresses][aba][requested]"=false \
  -d "features[financial_addresses][aba][bank]"=fifth_third \
  -d "features[inbound_transfers][ach][requested]"=true \
  -d "features[intra_stripe_flows][requested]"=true \
  -d "features[outbound_payments][ach][requested]"=true \
  -d "features[outbound_payments][us_domestic_wire][requested]"=true \
  -d "features[outbound_transfers][ach][requested]"=true \
  -d "features[outbound_transfers][us_domestic_wire][requested]"=true

Stripe は以下のレスポンスを返します。

{
  id: fa_123,
  ...
}

次に、金融口座 ID を指定して新しいカードを作成します。

curl https://api.stripe.com/v1/issuing/cards \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d financial_account=fa_xxx \
  -d currency=usd \
  -d type=virtual

苦情の追跡

Your complaints tracking process has one update. After your connected accounts start using Fifth Third Bank, the complaint_channel field for each complaint includes the following new channels:

• 従業員
• エグゼクティブ
• 代理申請者
• Bancorp のインシデント
• 消費者報告機関
• 連邦
• CFPB
• BBB
• 取締役会

更新後の苦情トラッカーを Stripe から受け取るまで、アクションは不要です。

プラットフォームの金融口座

Your platform’s financial account remains open at Evolve. For now, we won’t open a second platform financial account at Fifth Third Bank. However, we plan to introduce this option within a few months. Until then, instantly transfer funds from your platform financial account at Evolve to your connected accounts’ financial accounts at Fifth Third Bank using Stripe network transfers.