Payment Methods API を使用した Connect プラットフォーム
Connect プラットフォームの所有者は、Payment Methods API でサポートされる追加の支払い方法を利用できます。連結されたユーザーへの支払いの作成、およびお客様に最適なアプローチについては、Connect の支払いと手数料に関するドキュメントをご覧ください。
ダイレクト支払いを選択する場合、さまざまな方法で Connect とともに Payment Methods API を使用できます。
ダイレクト支払いで Payment Method API を使用する
ダイレクト支払いでは、連結アカウントに PaymentMethod を作成する必要があります。いずれの手段を使用する場合でも、まず連結アカウントで使用する予定の決済手段を有効化する必要があります。
PaymentIntent の確定時に PaymentMethod を作成して関連付ける
Connect で Payment Method API を使用する推奨方法は、Payment Intent の確定時に支払い方法を保存することです。このプロセスの詳細については、支払い時にカードを保存するを参照してください。
Stripe.js で PaymentIntent の確定時に Stripe オブジェクトを初期化し、stripeAccount
に連結アカウントの ID を設定して、setup_future_usage
オプションを使用します。これにより、顧客がこの連結アカウントの将来の支払いで再利用できるように、支払い情報が自動的に保存されます。
各タイプの支払い方法の確定に関する詳細については、Stripe.js を使用した PaymentIntents をご覧ください。
var stripe = Stripe(
, { stripeAccount:'pk_test_TYooMQauvdEDq54NiTphI7jx', }); (async () => { const {paymentIntent, error} = await stripe.confirmCardPayment( '{{PAYMENT_INTENT_CLIENT_SECRET}}', { payment_method: { card: card, billing_details: { name: 'Jenny Rosen' } }, setup_future_usage: 'off_session', } ); })();'{{CONNECTED_ACCOUNT_ID}}'
サーバで PaymentIntents を確定している場合は、サポートされている任意のライブラリを使用して、Stripe-Account ヘッダーを使用した認証を利用できます。詳細情報については、PaymentIntent の確定をご覧ください。
連結アカウントで直接 PaymentMethods を作成する
createPaymentMethod
を使用して、連結アカウントで直接 PaymentMethod を作成することもできます。Stripe.js で Stripe オブジェクトを初期化して、stripeAccount
に連結アカウントの ID を設定します。
// Set the connected Stripe Account on which the PaymentMethod should be created const stripe = Stripe(
, { stripeAccount:'pk_test_TYooMQauvdEDq54NiTphI7jx', }); (async () => { const {paymentMethod, error} = await stripe.createPaymentMethod({ type: 'card', card: cardElement, billing_details: { name: 'Jenny Rosen', }, }); // Handle error or paymentMethod })();'{{CONNECTED_ACCOUNT_ID}}'
サーバで PaymentMethods を作成している場合は、サポートされている任意のライブラリを使用して、Stripe-Account ヘッダーを使用した認証を利用できます。
PaymentMethods を複製する
プラットフォームで PaymentMethods を作成し、それを連結アカウントに複製して、そこでダイレクト支払いを作成することもできます。現在複製は、type
が card
と us_bank_account
のいずれかに設定されている PaymentMethods でのみサポートされます。
PaymentMethod を作成して顧客に関連付けたら、連結アカウントの ID を Stripe-Account
ヘッダーとして使用して、連結アカウントでその PaymentMethod を複製できます。Payment Methods API の詳細をご覧ください。
連結アカウントで PaymentMethods を再利用する場合は、PaymentIntents で支払いの作成に使用する前に、PaymentMethods を顧客に関連付けます。セキュリティ上の理由により、顧客に関連付けられた PaymentMethods を複製する場合は、リクエストで顧客 ID を指定する必要があります。
事前に PaymentMethods を顧客に関連付けることなく、連結アカウントに複製することができます。ただし、顧客に関連付けられていない PaymentMethod は 1 回しか使用できないため、元の PaymentMethod が使用されることに注意してください。