# Connect で Issuing の残高に入金する 連結アカウントの Issuing に資金を追加する方法をご紹介します。 発行されたカードを取引に使用するには、事前にカードに関連付けられた連結アカウントの [Issuing 残高](https://docs.stripe.com/issuing/funding/balance.md)に資金を割り当てる必要があります。Issuing 残高にはカードに予約された資金が保持され、利益、[入金](https://docs.stripe.com/payouts.md)、他の Stripe プロダクトからの資金から安全に分離されます。 ## 銀行口座から資金供給する 外部口座から Issuing 残高への資金追加には「資金の追加」と「資金の引き出し」という 2 つのオプションがあり、それぞれ設定が異なります。 - **資金の引き出し**は、アメリカのデフォルトの資金追加オプションですが、ユーロ圏やイギリスでは利用できません。外部銀行口座を確認する必要があり、通常の場合、送金の遅延が発生します (最大 5 営業日)。このオプションを使用すると、トップアップ (資金追加) の発生元の銀行の管理と特定が可能になります。 - **資金の追加**はイギリスとユーロ圏で利用でき、アメリカではベータ機能として利用できます。このオプションを使用すると、ご自身の銀行口座からの資金を Stripe に補充できます。資金の追加では、使用する処理方法 (ACH、電信送金など) によっては同日中に入金を受けることもできます。 #### 融資の引き出し (アメリカ) ユーザーの銀行口座から連結アカウントのトップアップ (資金の追加) を行うには、事前にアカウント情報を収集して確認する必要があります。Stripe では [Stripe.js](https://docs.stripe.com/payments/elements.md) を介した収集と少額入金) を使用した確認のオプションを利用できます。 #### マイクロデポジット ### ユーザーの情報を収集する ユーザーの銀行口座から資金を引き落とすには、銀行口座の情報を徴収し、口座引き落とし承認の証拠を提出する必要があります。これは[同意書](https://docs.stripe.com/api/sources/create.md#create_source-mandate)と呼ばれるもので、お客様と Stripe の双方が ACH ネットワークルールに準拠していることを保証すると同時に、不審請求の申し立てへの対処を容易にするために、お客様に反証資料へのアクセスを提供します。 以下をキャプチャーするフォームを作成します。 - 名前 - 金融番号 - 口座番号 顧客が同意書を提出したら、以下を記録します。 - IP アドレス - ユーザーエージェント - 日付 上記の代わりにユーザーから「オフライン」(電話や紙の契約書など) で同意書を収集する場合、Stripe に承認の証拠をアップロードする必要はありません。承諾の記録はお客様自身で保管するものとし、反証資料の提出を求められた場合に備えて、連絡先メールアドレスをご提供ください。 ### トークンとソースの作成 [銀行口座トークン API](https://docs.stripe.com/api/tokens/create_bank_account.md) を使用してトークンを作成し、そのトークンでソースを作成します。資金供給先の連結アカウントで銀行口座トークンと `source` を作成します。 > これらの `Source` トークンを独自のシステムに格納して、実装で取得できるようにします。現在、Stripe ではトークンの作成後にプログラムによってそのトークンを取得またはリストする手段を提供していません。 ```curl curl https://api.stripe.com/v1/tokens \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "bank_account[country]=US" \ -d "bank_account[currency]=usd" \ -d "bank_account[account_holder_name]=Jenny Rosen" \ -d "bank_account[account_holder_type]=individual" \ -d "bank_account[routing_number]=110000000" \ -d "bank_account[account_number]=000000000009" ``` 取得したトークンを使用して `source` を使用する: ```curl curl https://api.stripe.com/v1/sources \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d type=ach_debit \ -d currency=usd \ -d token={{TOKEN_ID}} \ -d "owner[address][line1]=510 Townsend Street" \ -d "owner[address][city]=San Francisco" \ -d "owner[address][state]=California" \ -d "owner[address][country]=US" \ --data-urlencode "owner[email]=jenny.rosen@example.com" \ -d "owner[name]=Jenny Rosen" \ -d "owner[phone]=5554443333" ``` ### マイクロデポジットでソースを認証 明細書に **ACCTVERIFY** と表記された 2 件の少額入金が 1 〜 2 日以内に銀行口座に送金されます。ユーザーからこれら 2 件の金額を回収し、銀行口座を確認してください。 ```curl curl https://api.stripe.com/v1/sources/{{SOURCE_ID}}/verify \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d "values[]=32" \ -d "values[]=45" ``` ### 連結アカウントの Issuing 残高をトップアップ (残高を補充) する トップアップを使用して、連結アカウントの Issuing 残高に資金を供給するには、作成された `source`を渡して、`destination_balance` を `issuing` に設定します。 #### curl ```bash curl https://api.stripe.com/v1/topups \ -u <>: \ -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \ -d "amount"=2000 \ -d "currency"="usd" \ -d "description"="Top-up for week of May 31" \ -d "destination_balance"="issuing" \ -d "statement_descriptor"="Top-up" \ -d "source"="{{SOURCE_ID}}" ``` #### 資金を追加する (アメリカ) 口座情報照会には、当該の地域で適用できる銀行口座と金融機関情報が含まれています。その口座に資金が入金されると、トップアップ (資金補充) を使用してすぐに Stripe アカウントの残高で利用できるようになります。口座情報照会は、API で作成できます。特定の通貨に対して指定される銀行口座情報は一意であり、何度でも資金を受け取ることができます。場合によっては、資金がお客様の銀行で通貨換算されることがありますが、必ず指定された通貨で Stripe 残高に入金されます。 | 地域 | 支払いスキーム | サポートされている通貨 | スピード | 最大承認金額 | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ---------------------------- | ---------------------- | | US (ベータ) | アメリカの銀行からの*電信送金* (Also called a bank transfer or credit transfer, wire transfers are a method of electronic funds transfers that move money from a payer to a payee)のみ | USD | 数分 ~ 1 営業日 | 銀行によって異なりますが、通常は数百万ドル | | *ACH* (Automated Clearing House (ACH) is a US financial network used for electronic payments and money transfers that doesn’t rely on paper checks, credit card networks, wire transfers, or cash) クレジットトランスファー | USD | 数時間 ~ 数営業日 | 通常 25,000 USD 未満、ただし銀行により異なる | | EU | SEPA クレジットトランスファー | EUR | 約 1 日 | 9 億 9999 万 9999.99 GBP | | GB | FPS | GBP | 銀行の営業時間中の約 2 時間、また翌営業日の開始時刻。 | 100 万 GBP | | BACS | GBP | 2 ~ 3 営業日 | 2,000 万 GBP | ### API を使用して口座情報を作成する (ベータ) 資金を追加するためのアカウント情報にアクセスするには、[口座情報作成 API](https://docs.stripe.com/api/issuing/funding_instructions/create.md) を使用します。 これにより、銀行振込を使用して、加盟店アカウントや各 Connect アカウントが資金を追加するための一意の口座情報が返されます。 ```bash curl https://api.stripe.com/v1/issuing/funding_instructions \ -u <>: \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \ -d "funding_type"="bank_transfer" \ -d "bank_transfer[type]"="us_bank_transfer" \ -d "currency"="usd" ``` リクエストが成功すると、次のようなレスポンスが返されます。 ```json { "object": "funding_instructions", "bank_transfer": { "country": "US", "financial_addresses": [ { "aba": { "account_number": "test_c44b907982bf", "bank_name": "TEST BANK", "routing_number": "110000000" }, "supported_networks": [ "ach", "domestic_wire_us" ], "type": "aba" } ], "type": "us_bank_transfer" }, "currency": "usd", "funding_type": "bank_transfer", "livemode": false } ``` ### Funding Instructions API を使用して資金の追加をテストする (ベータ) *サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)環境で Issuing 残高への銀行振込をシミュレーションできます。[資金追加](https://docs.stripe.com/api/issuing/funding_instructions/fund.md)エンドポイントを呼び出して、振込金額を指定します。最小通貨単位の正の整数で `amount` パラメーターを設定します。シミュレーションする資金の入金通貨を指定する必要があります。たとえば、1 USD のテスト送金を作成するには、金額には `100` を、通貨には `usd` を使用します。 銀行振込のシミュレーション後に、指定した金額がテスト用の Issuing 残高に追加されます。[ダッシュボード](https://dashboard.stripe.com/balance/overview#issuing-summary)または[残高の取得](https://docs.stripe.com/api/balance/balance_retrieve.md)エンドポイントで最新の残高を確認します。テストエンドポイントを呼び出すたびに、新しい銀行振込をシミュレーションできます。 > 現在、クライアントライブラリはサポートされていません。 ```bash curl https://api.stripe.com/v1/test_helpers/issuing/fund_balance \ -u <>: \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \ -d "amount"=100 \ -d "currency"="usd" ``` リクエストが成功すると、次のようなレスポンスが返されます。 ```json { "object": "funding_instructions", "bank_transfer": { "country": "US", "financial_addresses": [ { "aba": { "account_number": "test_c44b907982bf", "bank_name": "TEST BANK", "routing_number": "110000000" }, "supported_networks": [ "ach", "domestic_wire_us" ], "type": "aba" } ], "type": "us_bank_transfer" }, "currency": "usd", "funding_type": "bank_transfer", "livemode": false } ``` ### 早期アクセスをリクエストする アメリカでの資金の追加のご利用は現在、アメリカのベータユーザーに限定されています。ベータにご参加いただくには、Issuing の利用者である必要があります。ベータへのアクセスをリクエストするには、Stripe アカウントにログインしてページを更新してください。詳細は [Stripe にお問い合わせください](https://stripe.com/contact/sales)。 #### 資金を追加する (ユーロ圏) 口座情報照会には、当該の地域で適用できる銀行口座と金融機関情報が含まれています。その口座に資金が入金されると、トップアップ (資金補充) を使用してすぐに Stripe アカウントの残高で利用できるようになります。口座情報照会は、API で作成できます。特定の通貨に対して指定される銀行口座情報は一意であり、何度でも資金を受け取ることができます。場合によっては、資金がお客様の銀行で通貨換算されることがありますが、必ず指定された通貨で Stripe 残高に入金されます。 | 地域 | 支払いスキーム | サポートされている通貨 | スピード | 最大承認金額 | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ---------------------------- | ---------------------- | | US (ベータ) | アメリカの銀行からの*電信送金* (Also called a bank transfer or credit transfer, wire transfers are a method of electronic funds transfers that move money from a payer to a payee)のみ | USD | 数分 ~ 1 営業日 | 銀行によって異なりますが、通常は数百万ドル | | *ACH* (Automated Clearing House (ACH) is a US financial network used for electronic payments and money transfers that doesn’t rely on paper checks, credit card networks, wire transfers, or cash) クレジットトランスファー | USD | 数時間 ~ 数営業日 | 通常 25,000 USD 未満、ただし銀行により異なる | | EU | SEPA クレジットトランスファー | EUR | 約 1 日 | 9 億 9999 万 9999.99 GBP | | GB | FPS | GBP | 銀行の営業時間中の約 2 時間、また翌営業日の開始時刻。 | 100 万 GBP | | BACS | GBP | 2 ~ 3 営業日 | 2,000 万 GBP | ### API を使用して口座情報を作成する > この API は現在、ユーロ圏およびイギリスの本番環境の利用が可能なアカウントを持つユーザーのみが利用できます。 資金を追加するためにアカウント情報にアクセスするには、口座情報の作成エンドポイントを使用します。 これにより、銀行振込を使用して、加盟店アカウントや各 Connect アカウントが資金を追加するための一意の口座情報が返されます。 ```bash curl https://api.stripe.com/v1/issuing/funding_instructions \ -u <>: \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \ -d "funding_type"="bank_transfer" \ -d "bank_transfer[type]"="eu_bank_transfer" \ -d "currency"="eur" ``` リクエストが成功すると、次のようなレスポンスが返されます。 ```json { "object": "funding_instructions", "bank_transfer": { "country": "DE", "financial_addresses": [ { "iban": { "account_holder_name": "Stripe Technology Europe Limited", "bic": "SXPYDEHH", "country": "DE", "iban": "DE00000000000000000001" }, "supported_networks": [ "sepa" ], "type": "iban" } ], "type": "eu_bank_transfer" }, "currency": "eur", "funding_type": "bank_transfer", "livemode": false } ``` ### Funding Instructions API を使用して資金の送金をテストする *サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)環境で Issuing 残高への銀行振込をシミュレーションできます。[資金追加](https://docs.stripe.com/api/issuing/funding_instructions/fund.md)エンドポイントを呼び出して、振込金額を指定します。最小通貨単位の正の整数で `amount` パラメーターを設定します。シミュレーションする資金の入金通貨を指定する必要があります。たとえば、1 EUR のテスト振込を作成するには、金額には `100` を、通貨には `eur` を使用します。 銀行振込のシミュレーション後に、指定した金額がテスト用の Issuing 残高に追加されます。[ダッシュボード](https://dashboard.stripe.com/balance/overview#issuing-summary)または[残高の取得](https://docs.stripe.com/api/balance/balance_retrieve.md)エンドポイントから最新の残高を確認します。テストエンドポイントを呼び出すたびに、新しい銀行振込をシミュレーションできます。 ```bash curl https://api.stripe.com/v1/test_helpers/issuing/fund_balance \ -u <>: \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \ -d "amount"=100 \ -d "currency"="eur" ``` リクエストが成功すると、次のようなレスポンスが返されます。 ```json { "object": "funding_instructions", "bank_transfer": { "country": "DE", "financial_addresses": [ { "iban": { "account_holder_name": "Stripe Technology Europe Limited", "bic": "SXPYDEHH", "country": "DE", "iban": "DE00000000000000000001" }, "supported_networks": [ "sepa" ], "type": "iban" } ], "type": "eu_bank_transfer" }, "currency": "eur", "funding_type": "bank_transfer", "livemode": false } ``` #### 資金を追加する (イギリス) 口座情報照会には、当該の地域で適用できる銀行口座と金融機関情報が含まれています。その口座に資金が入金されると、トップアップ (資金補充) を使用してすぐに Stripe アカウントの残高で利用できるようになります。口座情報照会は、API で作成できます。特定の通貨に対して指定される銀行口座情報は一意であり、何度でも資金を受け取ることができます。場合によっては、資金がお客様の銀行で通貨換算されることがありますが、必ず指定された通貨で Stripe 残高に入金されます。 | 地域 | 支払いスキーム | サポートされている通貨 | スピード | 最大承認金額 | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ---------------------------- | ---------------------- | | US (ベータ) | アメリカの銀行からの*電信送金* (Also called a bank transfer or credit transfer, wire transfers are a method of electronic funds transfers that move money from a payer to a payee)のみ | USD | 数分 ~ 1 営業日 | 銀行によって異なりますが、通常は数百万ドル | | *ACH* (Automated Clearing House (ACH) is a US financial network used for electronic payments and money transfers that doesn’t rely on paper checks, credit card networks, wire transfers, or cash) クレジットトランスファー | USD | 数時間 ~ 数営業日 | 通常 25,000 USD 未満、ただし銀行により異なる | | EU | SEPA クレジットトランスファー | EUR | 約 1 日 | 9 億 9999 万 9999.99 GBP | | GB | FPS | GBP | 銀行の営業時間中の約 2 時間、また翌営業日の開始時刻。 | 100 万 GBP | | BACS | GBP | 2 ~ 3 営業日 | 2,000 万 GBP | ### API を使用して口座情報を作成する > この API は現在、ユーロ圏およびイギリスの本番環境の利用が可能なアカウントを持つユーザーのみが利用できます。 資金を追加するためにアカウント情報にアクセスするには、口座情報の作成エンドポイントを使用します。 これにより、銀行振込を使用して、加盟店アカウントや各 Connect アカウントが資金を追加するための一意の口座情報が返されます。 ```bash curl https://api.stripe.com/v1/issuing/funding_instructions \ -u <>: \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \ -d "funding_type"="bank_transfer" \ -d "bank_transfer[type]"="gb_bank_transfer" \ -d "currency"="gbp" ``` ```json { "object": "funding_instructions", "bank_transfer": { "country": "GB", "financial_addresses": [ { "sort_code": { "account_holder_name": "Stripe Payments UK Limited", "sort_code": "000000", "account_number": "00000000" }, "supported_networks": [ "bacs", "fps" ], "type": "sort_code" } ], "type": "gb_bank_transfer" }, "currency": "gbp", "funding_type": "bank_transfer", "livemode": false } ``` ### Funding Instructions API を使用して資金の送金をテストする *サンドボックス* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes)環境で Issuing 残高への銀行振込をシミュレーションできます。[資金追加](https://docs.stripe.com/api/issuing/funding_instructions/fund.md)エンドポイントを呼び出して、振込金額を指定します。最小通貨単位の正の整数で `amount` パラメーターを設定します。シミュレーションする資金の入金通貨を指定する必要があります。たとえば、1 GBP のテスト送金を作成するには、金額には `100` を、通貨には `gbp` を使用します。 銀行振込のシミュレーション後に、指定した金額がテスト用の Issuing 残高に追加されます。[ダッシュボード](https://dashboard.stripe.com/balance/overview#issuing-summary)または[残高の取得](https://docs.stripe.com/api/balance/balance_retrieve.md)エンドポイントから最新の残高を確認します。テストエンドポイントを呼び出すたびに、新しい銀行振込をシミュレーションできます。 ```bash curl https://api.stripe.com/v1/test_helpers/issuing/fund_balance \ -u <>: \ -H "Stripe-Account: {{CONNECTED_ACCOUNT_ID}}" \ -d "amount"=100 \ -d "currency"="gbp" ``` リクエストが成功すると、次のようなレスポンスが返されます。 ```json { "object": "funding_instructions", "bank_transfer": { "country": "GB", "financial_addresses": [ { "sort_code": { "account_holder_name": "Stripe Payments UK Limited", "sort_code": "000000", "account_number": "00000000" }, "supported_networks": [ "bacs", "fps" ], "type": "sort_code" } ], "type": "gb_bank_transfer" }, "currency": "gbp", "funding_type": "bank_transfer", "livemode": false } ``` ## 連結アカウントの Stripe 残高から資金供給する Stripe 残高から Issuing 残高に売上を送金するには、[Balance Transfer API のプライベートベータに登録する](https://docs.stripe.com/issuing/connect/funding.md#request-early-access)必要があります。 #### curl ```bash curl https://api.stripe.com/v1/balance_transfers \ -u <>: \ -H "Stripe-Account: {{CONNECTED_STRIPE_ACCOUNT_ID}}" \ -d amount=1000 \ -d currency=usd \ -d "source_balance[type]"=payments \ -d "destination_balance[type]"=issuing ``` 連結アカウントの Stripe 残高からの送金は、アメリカでは 24 時間 365 日利用でき、即座に実行されます。イギリスとユーロ圏では 1 営業日以内に実行されます。これにより、Stripe Payments で得られた売上をすばやく簡単に Stripe Issuing での支払いに利用できます。 利用可能な Stripe 残高を上限とする金額を移動できます。送金が保留されているあいだは、Issuing 残高の資金を利用できません。 [残高の取得](https://docs.stripe.com/api/balance/balance_retrieve.md)エンドポイントを使用して、[source_type](https://docs.stripe.com/api/balance/balance_object.md#balance_object-available-source_types) ごとに分類された利用可能な Stripe 残高の金額を取得できます。 ### 早期アクセスをリクエストする Balance Transfer API へのアクセスは現在、ベータユーザーに限定されています。ベータにご参加いただくには、Issuing の利用者である必要があります。ベータへのアクセスをリクエストするには、Stripe アカウントにログインしてページを更新してください。詳細は [Stripe にお問い合わせください](https://stripe.com/contact/sales)。 ## Issuing 残高を取得する 連結アカウントの現在の Issuing 残高を確認するには、[Balance (残高) API](https://docs.stripe.com/api/balance/balance_retrieve.md) の GET エンドポイントを呼び出し、連結アカウントの ID をヘッダーに渡します。 ```curl curl https://api.stripe.com/v1/balance \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" ``` `balance` オブジェクトが対応する `issuing` オブジェクトとともに返されます。issuing オブジェクトには現在の利用可能残高が含まれています。 ```json { "object": "balance", ... "issuing": { "available": [ { "amount": 100, "currency": "usd" } ] }, "livemode": false } ``` ## Issuing 残高を外部口座に入金する Issuing 残高にある資金は、[Payouts (入金) API](https://docs.stripe.com/api/payouts/create.md) の POST エンドポイントを使用し、入金の `source_balance` に `issuing` を指定することで、連結アカウントの[外部の銀行口座](https://docs.stripe.com/api/external_accounts.md)に入金できます。 ```curl curl https://api.stripe.com/v1/payouts \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d source_balance=issuing \ -d amount=100 \ -d currency=usd ```