既存の顧客の支払い

allow_redisplay パラメーターを指定して list Payment Method エンドポイントを呼び出し、顧客の再利用可能な決済手段を取得します。

curl -G https://api.stripe.com/v1/customers/{{CUSTOMER_ID}}/payment_methods \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d allow_redisplay=always

API レスポンスデータを使用して、独自の UI に支払い方法を表示し、顧客が選択できるようにします。

PaymentIntent を作成して、顧客が選択した決済手段で請求を試みます。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d customer={{CUSTOMER_ID}} \
  -d payment_method={{PAYMENT_METHOD_ID}} \
  -d confirm=true \
  --data-urlencode return_url="https://example.com/order/123/complete"

API コールが 402 レスポンスで失敗した場合は、支払いが拒否されたことを意味します。再試行するか、別の決済手段を試すように顧客に依頼します。

PaymentIntent が正常に作成されたとして、status を確認します。

• succeeded は、顧客が想定どおりに請求されたことを示します。顧客に成功のメッセージを表示します。
• requires_action は、3D セキュアによる認証など、追加のアクションを求める必要があることを示します。フロントエンドで handleNextAction を呼び出し、顧客が実行する必要があるアクションをトリガーします。

const { error, paymentIntent } = await stripe.handleNextAction({
  clientSecret: "{{CLIENT_SECRET}}"
});

if (error) {
  // Show error from Stripe.js
} else {
  // Actions handled, show success message
}

支払いが完了すると、Stripe は payment_intent.succeeded イベントを送信します。ダッシュボードの Webhook ツールを使用するか Webhook のガイドに従ってこれらのイベントを受信し、顧客への注文確認メールの送信、データベースでの売上の記録、配送ワークフローの開始などのアクションを実行します。

クライアントからのコールバックを待つのではなく、これらのイベントをリッスンします。クライアントでは、コールバックが実行される前に顧客がブラウザーのウィンドウを閉じたり、アプリを終了する場合、また悪意を持つクライアントがレスポンスを不正操作する場合もあります。非同期型のイベントをリッスンするよう組み込みを設定すると、単一の組み込みで複数の異なるタイプの支払い方法を受け付けることができます。

Payment Element を使用して支払いを回収する場合は、payment_intent.succeeded イベントのほかにこれらのイベントを処理することをお勧めします。