Charges API を使用 しよう してカードを保存 ほぞん する 支払 しはら い詳細 しょうさい を保存 ほぞん し、後 あと で顧客 こきゃく に請求 せいきゅう する方法 ほうほう をご紹介 しょうかい します。レガシーの API The content of this section refers to a Legacy feature. Use the Payment Intents API instead.
Charges API は、以下 いか の機能 きのう をサポートしていません。これらの多 おお くはクレジットカードのコンプライアンスのために必要 ひつよう となります。
顧客 こきゃく の支払 しはら い情報 じょうほう を収集 しゅうしゅう すると、Stripe トークンが作成 さくせい されます。このトークンは 1 回 かい しか使用 しよう できませんが、支払 しはら いごとに顧客 こきゃく のカード詳細 しょうさい をリクエストする必要 ひつよう があるわけではありません。
Stripe は Customer (顧客 こきゃく ) オブジェクトを提供 ていきょう しているため、後 あと で使用 しよう するためにこの情報 じょうほう やその他 た の情報 じょうほう を保存 ほぞん できます。Customer
オブジェクトを使用 しよう して、サブスクリプション または将来 しょうらい の 1 回 かい 限 かぎ りの支払 しはら いを作成 さくせい できます。
今後 こんご に備 そな えてクレジットカード詳細 しょうさい を保存 ほぞん するPayment Intents を使用 しよう してカードを保存 ほぞん するには このページでは、Charges API を使用 しよう したカードの保存 ほぞん について説明 せつめい します。SCA による支払 しはら い拒否 きょひ の増加 ぞうか を回避 かいひ するには、Stripe の SCA 対応 たいおう 支払 しはら い API を使用 しよう して、カードを保存 ほぞん して再 さい 利用 りよう します。
サブスクリプション を含 ふく め、以降 いこう の支払 しはら いにカードを利用 りよう できるようにするには、メールアドレスとトークン化 か されたカード情報 じょうほう を指定 してい して、Charge
ではなく新 あたら しい Customer
を作成 さくせい します。
その後 ご の支払 しはら いに使用 しよう できるように、必 かなら ず顧客 こきゃく ID をお客様 きゃくさま 側 がわ で保存 ほぞん してください。それ以降 いこう は、支払 しはら いリクエストでカードの代 か わりに顧客 こきゃく ID を渡 わた すことで、その顧客 こきゃく に請求 せいきゅう できます。
# Create a Customer:
curl https://api.stripe.com/v1/customers \
-u sk_test_09l3shTSTKHYCzzZZsiLl2vA
: \
-d source = tok_mastercard \
-d email = "paying.user@example.com"
# Charge the Customer instead of the card:
curl https://api.stripe.com/v1/charges \
-u sk_test_09l3shTSTKHYCzzZZsiLl2vA
: \
-d amount = 1000 \
-d currency = usd \
-d customer = cus_7sqFSKcBzzYEAf
# YOUR CODE: Save the customer ID and other info in a database for later.
# When it's time to charge the customer again, retrieve the customer ID.
curl https://api.stripe.com/v1/charges \
-u sk_test_09l3shTSTKHYCzzZZsiLl2vA
: \
-d amount = 1500 \
-d currency = usd \
-d customer = cus_7sqFSKcBzzYEAf
保存 ほぞん したカード詳細 しょうさい を使用 しよう した支払 しはら いは、1 回 かい 限 かぎ りの支払 しはら い と同 おな じ方法 ほうほう でカスタマイズできます。
注 ちゅう **Stripe は通常 つうじょう 、保存 ほぞん 時 じ にカード情報 じょうほう を検証 けんしょう します。**これが発生 はっせい するタイミングの詳細 しょうさい については、請求 せいきゅう しないでクレジットカードの有効 ゆうこう 性 せい を確認 かくにん する をご覧 らん ください。 このプロセスの結果 けっか 、顧客 こきゃく の明細 めいさい 書 しょ に、現地 げんち 通貨 つうか での少額 しょうがく の請求 せいきゅう に対 たい する一時 いちじ 的 てき なオーソリ が表示 ひょうじ される場合 ばあい があります。これは、今後 こんご の請求 せいきゅう が成功 せいこう することを保証 ほしょう するものではありません (たとえば、カードに十分 じゅうぶん な資金 しきん がなくなった、紛失 ふんしつ または盗難 とうなん が報告 ほうこく された、または口座 こうざ が閉鎖 へいさ された場合 ばあい など)。このプロセスでは、Radar による従来 じゅうらい の銀行 ぎんこう 確認 かくにん (セキュリティコードや郵便 ゆうびん 番号 ばんごう ) などの、確認 かくにん の結果 けっか も更新 こうしん されます。
カード情報 じょうほう の自動 じどう 更新 こうしん クレジットカードがカード発行 はっこう 会社 かいしゃ によって再 さい 発行 はっこう された場合 ばあい でも、保存 ほぞん された支払 しはら い方法 ほうほう の詳細 しょうさい は引 ひ き続 つづ き機能 きのう します。Stripe はカードネットワーク と連携 れんけい し、顧客 こきゃく が新 あたら しいカードを受 う け取 と るたびに (有効 ゆうこう 期限切 きげんぎ れのカードの交換 こうかん や、紛失 ふんしつ または盗難 とうなん が報告 ほうこく されたカードを再 さい 発行 はっこう する場合 ばあい など)、保存 ほぞん したカード詳細 しょうさい の自動 じどう 更新 こうしん を試 こころ みます。これにより、顧客 こきゃく は中断 ちゅうだん なくサービスを利用 りよう し続 つづ けることができ、事業 じぎょう 者 しゃ はカードが交換 こうかん されるたびに新 あたら しいカード情報 じょうほう を収集 しゅうしゅう する必要 ひつよう を軽減 けいげん できます。
カードの自動 じどう 更新 こうしん には、カード発行 はっこう 会社 かいしゃ がネットワークに加盟 かめい し、この情報 じょうほう を提供 ていきょう している必要 ひつよう があります。アメリカでは広範囲 こうはんい でサポートされているため、Stripe はアメリカ国内 こくない で発行 はっこう されたほとんどのアメリカン・エキスプレス、Visa、Mastercard、ディスカバーのクレジットカードを自動的 じどうてき に更新 こうしん することができます。アメリカ国外 こくがい でのサポート内容 ないよう は国 くに によって異 こと なります。自動 じどう 更新 こうしん に対応 たいおう しているカードを識別 しきべつ することはできません。
Stripe Webhook をリッスンしてカード更新 こうしん アクティビティを確認 かくにん できます。
payment_ method. updated
イベントは、API コールを介 かい したカードへの更新 こうしん を通知 つうち します。payment_ method. automatically_ updated
イベントは、ネットワークからの自動 じどう カード更新 こうしん を通知 つうち します。これらのイベントには、カードの新 あたら しい有効 ゆうこう 期限 きげん と末尾 まつび 4 桁 けた が含 ふく まれるため、必要 ひつよう に応 おう じて自身 じしん のレコードを更新 こうしん できます。カードの更新 こうしん に新 あたら しいカード番号 ばんごう が含 ふく まれる場合 ばあい 、フィンガープリント は変更 へんこう されます。
デフォルトの支払 しはら い方法 ほうほう を変更 へんこう する 保存 ほぞん したカードを更新 こうしん する支払 しはら い方法 ほうほう 全体 ぜんたい を置 お き換 か える以外 いがい に、Update (更新 こうしん ) できるのは、保存 ほぞん されたカードの請求 せいきゅう 先 さき 住所 じゅうしょ および有効 ゆうこう 期限 きげん のみです。
保存 ほぞん したカードの多 おお くは自動的 じどうてき に更新 こうしん できますが、登録 とうろく されているカードを顧客 こきゃく が更新 こうしん または交換 こうかん できるプロセスを採用 さいよう する必要 ひつよう があります (たとえば、顧客 こきゃく が請求 せいきゅう 対象 たいしょう のカードを変更 へんこう したい場合 ばあい や、カードを自動的 じどうてき に更新 こうしん できない場合 ばあい など)。プロセスの最後 さいご に、Update customer (顧客 こきゃく 情報 じょうほう を更新 こうしん ) を呼 よ び出 だ し、source
パラメーターに新 あたら しいトークンを指定 してい する必要 ひつよう があります。
curl https://api.stripe.com/v1/customers/cus_V9T7vofUbZMqpv \
-u "sk_test_09l3shTSTKHYCzzZZsiLl2vA
:" \
-d source = tok_visa
これにより、新 あたら しいカードが以降 いこう の支払 しはら いのデフォルトの支払 しはら い方法 ほうほう として設定 せってい されます。また、以前 いぜん に保存 ほぞん したカードは削除 さくじょ されます。
複数 ふくすう の支払 しはら い方法 ほうほう 顧客 こきゃく には複数 ふくすう の支払 しはら い方法 ほうほう を保存 ほぞん することもできます。顧客 こきゃく に最初 さいしょ に保存 ほぞん された方法 ほうほう は、default_ source
として設定 せってい されます。これは、サブスクリプションに使用 しよう され、支払 しはら いリクエストは顧客 こきゃく ID のみを使用 しよう して作成 さくせい されます。
顧客 こきゃく に保存 ほぞん された支払 しはら い方法 ほうほう を管理 かんり し (カードの作成 さくせい や削除 さくじょ など)、顧客 こきゃく を更新 こうしん して、いつでも default_ source
を別 べつ の保存 ほぞん された支払 しはら い方法 ほうほう に変更 へんこう できます。
参照 さんしょう 情報 じょうほう