コンテンツにスキップ
アカウントを作成
または
サインイン
Stripe ドキュメントのロゴ
/
アカウントを作成
サインイン

連結アカウント間で顧客の支払い情報を複製するレガシー

顧客を共有している複数の連結アカウント間で支払い情報を再利用します。

注意

このページでは、レガシー機能について解説します。このサポートは予告なしに終了することがあるため、この機能を使用する場合は、システムを更新して、連結アカウント間で支払い情報を再利用できる既存プロセスを使用するようにしてください。詳細については、複数のアカウントでの支払い方法の共有をご覧ください。

一部のビジネスモデルでは、連結アカウント間で顧客の支払い情報を再利用すると便利です。たとえば、顧客がお客様の連結された売り手から購入する場合、別の連結された売り手から購入する際にクレジットカードや銀行口座の詳細を入力しなおす必要がなくなります。

Connect を使用すれば、以下の 3 ステップでこれを実現できます。

  1. プラットフォームアカウントで支払い方法とともに顧客を保存します。
  2. 連結アカウントの代理として顧客に請求する際に、トークンを作成して支払い方法を複製します。
  3. 新しいトークンを使用して支払いを作成します。

顧客を保存する

支払い方法を複製しない場合は、連結された Stripe アカウントごとに Stripe Customer (顧客) オブジェクトを保存します。支払い方法を複製する場合は、それらをプラットフォームの Stripe アカウントで保存します。

これは API コールですが、連結アカウントのキーではなく、必ずお客様自身のシークレットキーと公開可能キーを使用してください。

Command Line
curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode email="paying.user@example.com" \
  -d source=tok_mastercard

トークンを作成する

注意

プラットフォームで Sources API を使用している場合は、トークンを作成するのではなく、その顧客から Source を作成する必要があります。プラットフォームで PaymentMethod API を使用している場合は、その顧客から PaymentMethod を作成する必要があります。いずれかのガイドに沿って作業が終わりましたら、トークンを作成せずに支払いの作成へと進みます。

プラットフォームアカウントに保存された顧客を使用して連結アカウントで支払いを作成する準備ができたら、それに使用される新しいトークンを作成します。これには以下が必要です。

  • 支払い作成の対象となる連結アカウントの Stripe アカウント ID (acct_w8vGaHFRuaxE6SW1 など)
  • 請求対象の顧客のプラットフォームアカウントの ID (cus_5WCxLP9oOxdEkq など)
  • デフォルトではなく、特定のカードまたは銀行口座に請求する場合は、顧客のカードまたは銀行口座の ID
Command Line
curl https://api.stripe.com/v1/tokens \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d customer=
{{CUSTOMER_ID}}

支払いを作成する

前のステップで生成されたトークンを使用し、連結アカウントでそのトークンを顧客に関連付けます。

注意

複製された顧客で作成された支払いは、元の顧客には反映されません。この機能は、同じユーザに請求する必要のある複数の連結アカウントでの使用を目的としています。

注意

プラットフォームで Payment Methods API を使用している場合、source パラメータ―を渡すのではなく、payment_method パラメータ―として支払い方法 ID を渡す必要があります。

Command Line
curl https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d source=
{{TOKEN_ID}}

次に、customers.create コールで返された顧客 ID (cus_B9sH4WvMmrXbpm など) と支払い方法 ID (card_DreAkFhUumUl5I など) を使用して顧客に請求します。

Command Line
curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d amount=999 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d payment_method=
{{PAYMENT_METHOD_ID}}

参照情報

このページはお役に立ちましたか。
はいいいえ
お困りのことがございましたら 、サポートにお問い合わせください。
早期アクセスプログラムにご参加ください。
変更ログをご覧ください。
ご不明な点がございましたら、お問い合わせください。
LLM ですか？llms.txt を読んでください。
Powered by Markdoc