入金する

Stripe の公式ライブラリをインストールして、アプリケーションから API にアクセスできるようにします。

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

ユーザー (売り手またはサービスプロバイダー) がプラットフォームに登録したら、ユーザー Account (アカウント) (「連結アカウント」と呼ばれる) を作成し、決済を受け付けて資金をユーザーの銀行口座に移動できるようにします。連結アカウントは Stripe の API におけるお客様のユーザーを表し、Stripe がユーザーの本人確認をできるように情報要件の収集を容易にします。回答に対して支払う Q&A 商品の場合、連結アカウントはライターを表します。

登録フォームをカスタマイズする

プラットフォームの設定で、ユーザーが Connect リンクをクリックした際に表示される色とロゴを変更して、Express 登録フォームをカスタマイズします。

デフォルトの Express 登録フォーム

ブランディング設定

連結アカウントを作成して情報を事前入力する

/v1/accounts API を使用して連結アカウントを作成するには、連結アカウントのプロパティを指定するか、アカウントタイプを指定します。

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "controller[losses][payments]"=application \
  -d "controller[fees][payer]"=application \
  -d "controller[stripe_dashboard][type]"=express

連結アカウントの情報をすでに収集している場合、Account オブジェクトに情報を事前入力できます。個人情報、ビジネス情報、外部口座情報など、アカウントに関するどのような情報でも事前入力できます。

Connect アカウント登録で、事前入力された情報が要求されることはありません。ただし、アカウント所有者は Connect 利用規約に同意する前に、事前入力された情報を確認するよう求められます。

実装内容をテストする場合、テストデータを使用してアカウント情報を事前入力します。

アカウントリンクを作成する

以下の引数を使用して、Account Links (アカウントリンク) を作成します。

• account
• refresh_url
• return_url
• type = account_onboarding

curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d type=account_onboarding

アカウントリンクへユーザーをリダイレクトする

Account Links (アカウントリンク) リクエストへの応答には、キー url の値が含まれます。ユーザーをこのリンクにリダイレクトして、フローに送ります。Account Links API の URL は一時的なもので、アカウント所有者の個人情報へのアクセスを許可するため、一度しか使用できません。この URL にリダイレクトする前に、アプリケーションでユーザーを認証してください。情報を事前入力する場合は、アカウントリンクを生成する前に行う必要があります。アカウントリンクを作成した後で、その連結アカウントの情報を読み書きすることはできません。

プラットフォームに戻るユーザーに対応する

Connect アカウント登録では、ユーザーがプラットフォームにリダイレクトされるすべてのケースを処理するために、return_url と refresh_url の両方を渡す必要があります。ユーザーが快適に操作できるようにするには、これらを正しく実装することが重要です。

return_url

ユーザーが Connect アカウント登録フローを完了すると、Stripe はこの URL へのリダイレクトを行います。ただしこれは、すべての情報が収集されたことを意味するものでも、アカウントの要件がすべて満たされたことを意味するものでもありません。ユーザーがフローに正常に入り、そこから正常に出たことのみを意味します。

パラメーターの状態がこの URL を通じて渡されることはありません。ユーザーが return_url にリダイレクトされたら、以下のいずれかを行い、アカウントの details_submitted パラメーターの状態を確認します。

• account.updated イベントをリッスンする。
• Accounts API を呼び出して、返されたオブジェクトを調べる。

refresh_url

以下の場合、ユーザーは refresh_url にリダイレクトされます。

• リンクの期限が切れている (リンク作成後、数分が経過した)。
• リンクがすでに使用された (ユーザーがページを更新したか、ブラウザーで戻るまたは進むボタンをクリックした)。
• リンクが、URL にアクセスしてプレビューを試みる、メッセージングクライアントなどのサードパーティーアプリケーションに共有された。または、多くのクライアントが自動的にリンクにアクセスすることにより、期限切れになった場合。
• プラットフォームがアカウントにアクセスできなくなった。
• アカウントが拒否された。

refresh_url はサーバーで同じパラメーターを使用して Account Links (アカウントリンク) を再度呼び出し、シームレスな体験を作り上げるためにユーザーを Connect アカウント登録フローにリダイレクトする必要があります。

アカウント登録を完了していないユーザーを処理する

return_url にリダイレクトされたユーザーは、アカウント登録プロセスを完了していないことがあります。/v1/accounts エンドポイントを使用してユーザーのアカウントを取得し、charges_enabled を確認します。アカウント登録が完全でない場合は、UI プロンプトを表示し、ユーザーが後でアカウント登録を続行できるようにします。ユーザーは、新しいアカウントリンク (システムで生成された) で本番環境利用の申請を完了できます。アカウントの details_submitted パラメーターの状態を確認すると、ユーザーがアカウント登録プロセスを完了したかどうかを調べることができます。

資金を追加するには、ダッシュボードで残高セクションに移動します。残高に追加をクリックし、アカウントに資金を追加する理由を選択します。

資金を追加して連結アカウントに入金するには、連結アカウントに入金するを選択します。今後の返金や不審請求の申請を補填するため、またはプラットフォームのマイナス残高を返済するために残高に資金を追加する場合は、マイナス残高を補うを選択し、Stripe 残高への資金の追加をご覧ください。

銀行口座を確認する

未確認の銀行口座から初めて資金を追加する際は、ダッシュボードで確認プロセスを実行します。銀行口座が未確認の場合は、Stripe が行う 2 回の少額入金を確認する必要があります。これらの入金は、1 〜 2 営業日以内にオンラインの銀行明細書に表示されます。明細書表記として ACCTVERIFY が表示されます。

お客様のアカウントに少額入金が到着したら、Stripe からダッシュボードとメールで通知されます。確認プロセスを完了するには、残高セクションのダッシュボードの通知をクリック後、2 回の少額入金の金額を入力して、アカウントを確認をクリックします。

トップアップを作成する

確認の完了後は、Top-up (トップアップ) を使用して、アカウントの残高に資金を追加できます。

curl https://api.stripe.com/v1/topups \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=2000 \
  -d currency=usd \
  -d description="Top-up for week of May 31" \
  -d statement_descriptor="Weekly top-up"

資金を送金すると、取引先の銀行明細書に明細書表記が表示されます。デフォルトの明細書表記はトップアップです。トップアップの明細書表記と内部向け説明はカスタマイズできます。

資金を確認する

ダッシュボードの残高ページのトップアップタブで資金を確認します。資金を追加すると、そのたびに tu_XXXXXX という形式の一意の ID を持つ Top-up オブジェクトが作成されます。このオブジェクトは、トップアップの詳細ビューで確認できます。

売上処理のタイミング

アメリカのプラットフォームでは、ACH デビットを使用して資金を追加すると、Stripe 残高で利用可能になるまでに 5 ～ 6 営業日かかることがあります。Stripe サポートに連絡し、アカウントの審査をリクエストして、資金追加のタイミングを早めることができます。

Stripe でお客様のアカウントの詳細を確認することで、資金追加のプロセスを自動的に早められる可能性があります。

将来の返金および不審請求の申請のため、およびマイナス残高を補うための資金の追加は、銀行振込または電信送金で行うことができ、1 ～ 2 営業日後に利用可能になります。

API を使用して、利用可能な資金を連結アカウントに送金できます。たとえば、以下の呼び出しを行い、アカウントに 10 USD を送金します。

curl https://api.stripe.com/v1/transfers \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount=1000 \
  -d currency="usd" \
  -d destination="{{CONNECTED_STRIPE_ACCOUNT_ID}}"

デフォルトでは、連結アカウントに送金する資金は、連結アカウントの Stripe 残高に累積され、日次のローリング方式で入金されます。必要に応じて入金スケジュールを変更できます。

アカウントダッシュボードから、アカウントとその残高を確認できます。

テスト用の銀行トークンを使用して、アカウントとアカウント登録、入金、および資金の追加のフローをシミュレーションします。