オーソリを増額する
増分オーソリを使用すると、キャプチャーする前に、確定された PaymentIntent のオーソリ金額を増やすことができます。キャプチャー前は、各増分オーソリはクレジットカードの明細書に追加の保留項目として表示されます (たとえば、元のオーソリ額の 10 USD から 15 USD に増額された場合は、10 USD と 5 USD が保留中の項目として個別に表示されます)。キャプチャーすると、保留中のオーソリは削除され、キャプチャーされた金額の合計が 1 つの最終的な項目として表示されます。
提供状況
増分オーソリを使用する際には、次の制限にご注意ください。
- 強力な顧客認証 (SCA) 要件や同様の認証要件が適用される国にお客様とカード保有者が所在する場合は、現在ご利用いただけません。
- Visa、Mastercard、ディスカバーのみで利用できます。
- カードブランドによっては加盟店カテゴリーの制限があります (以下をご覧ください)。
増分オーソリと、Terminal で行われた対面支払いについて、詳細は増分オーソリをご覧ください。
IC+ 機能
Stripe は、IC+ 料金体系のユーザーに増分オーソリの機能を提供しています。Stripe の標準の料金体系をご利用で、この機能の利用をご希望の場合は、support.stripe.com で詳細をご確認ください。
カードネットワークと加盟店カテゴリー別の提供状況
増分オーソリは、下記の基準を満たす支払いで使用できます。ユーザーカテゴリーは、ダッシュボードで確認できます。
以下の条件を満たさない支払いで増分オーソリを実行しようとすると、エラーが発生します。
カードブランド | 加盟店の所在国 | 決済タイプ | 加盟店カテゴリー |
---|---|---|---|
Visa | グローバル | すべてのカード支払いタイプ | すべてのユーザーカテゴリー |
Mastercard | グローバル* | すべてのカード支払いタイプ | すべてのユーザーカテゴリー |
ディスカバー | グローバル | すべてのカード支払いタイプ | レンタカー、ホテル、地方 / 郊外の通勤・通学用交通機関 / 旅客輸送 (フェリーを含む)、旅客鉄道、貸切バス / バスツアー、汽船 / クルーズ客船、ボートレンタル / リース、食料品店とスーパーマーケット、電気車両充電、飲食店 / レストラン、酒場 (アルコール飲料)、ホテル / モーテル / リゾート、トレーラーパーク / キャンプ場、機器 / 工具 / かまど / 家電のレンタルおよびリース、レンタカー代理店、トラック / ユーティリティートレーラーのレンタル、トレーラーハウス / RV 車のレンタル、駐車場 / 駐車メーター / ガレージ、遊園地 / サーカス / 占い、その他レクリエーションサービス (上記に該当しないもの) |
ディスカバー | グローバル | 非対面カード支払い | タクシーとリムジン |
対応が限定されるネットワーク (ベータ)
ベストプラクティス
増分オーソリを使用する場合は、オーソリの推定額の詳細について、事前に最終利用者に通知します。推定額はその後の増分オーソリで引き上げられる可能性があります。その場合のベストプラクティスをご紹介します。
- 推定金額に対するオーソリであることと、決済時 (購入前) にオーソリリクエストが再度発生する可能性があることを開示します。
- 予想される取引総額の妥当な概算に基づいて、推定金額を決定します。
ネットワークによっては、適用されるネットワーク規則に則って、こうしたベストプラクティスが必要になる場合があります。
法令遵守に向けた取り組み
増分オーソリを使用する際、適用されるすべての法律、規制、ネットワーク規則に準拠する責任はお客様にあります。この機能を使用する際に利用する予定のカードネットワークのネットワーク規則をご覧になり、売上が該当する規則を遵守しているかを確認してください。規則はネットワークによって異なります。たとえば、ほとんどのカードネットワークでは初回のオーソリに含める推定金額の計算方法が制限されており、オーソリ時に取引額が判明している場合 (継続サブスクリプションの支払いなど)、その取引で増分オーソリを使用することは禁じられています。
このページに記載の情報のうち、これらの要件の遵守に関する情報は一般的なガイダンスであり、法律、税務、会計、その他の専門的なアドバイスではありません。ご自身の義務について不明な点がある場合は、専門家に相談することをお勧めします。
未キャプチャーの PaymentIntent を作成して確定する
request_incremental_authorization
パラメーターを使用して、増分予定の PaymentIntents を指定できます。
PaymentIntents はすべてデフォルトで増分可能です。PaymentIntent の増分を開始するタイミングを決定するには、if_available
または never
パラメーターを使用します。
if_available
: 作成した PaymentIntent では、今後の増分が増分オーソリ対応状況に基づいて許可されます。never
: 作成した PaymentIntent では、今後の増分が許可されません。
未キャプチャー分の支払いに対して増分オーソリを実行できるのは、PaymentIntent の確定後に限られます。確定前に支払いの金額を調整するには、代わりに update メソッドを使用します。
PaymentIntent 確認レスポンスでは、latest_charge の payment_method_details フィールドに、顧客の決済手段と上記の使用可能条件に基づいて available
または unavailable
が示され、これによって PaymentIntent が増分オーソリに使用可能かどうかが決まります (PaymentIntent 確認リクエストにおいて増分オーソリをリクエストしなかった場合は、unavailable
になります)。
// PaymentIntent Response { "id": "pi_ANipwO3zNfjeWODtRPIg", "object": "payment_intent", "amount": 1000, "amount_capturable": 1000, "amount_received": 0, ... // if latest_charge is expanded { "latest_charge": { "amount": 1000, "payment_method_details": { "card": { "incremental_authorization": { "status": "available" // or "unavailable" } } } ... } } }
増分オーソリを実行する
PaymentIntent に基づくオーソリ金額を増やすには、increment_authorization エンドポイントを使用し、新しい合計オーソリ金額を指定します。この金額は元のオーソリ金額より高くなければなりません。これにより、顧客のカードでその金額のオーソリが試行されます。1 つの PaymentIntent でこのエンドポイントを何度も呼び出せば、オーソリ金額をさらに増やすことができます。
PaymentIntent あたり最大 10 回までの増分オーソリの試行が可能です。
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/increment_authorization \ -u
: \ -d "amount"=1500sk_test_4eC39HqLyjWDarjtT1zdp7dc
増分オーソリが成功すると、更新された金額の PaymentIntent オブジェクトが返されますが、オーソリが失敗すると、代わりに card_declined エラーが返されます。その場合、PaymentIntent オブジェクトは前にオーソリされた金額を引き続きキャプチャーできます。増分オーソリが失敗した場合、その他の PaymentIntent フィールド (たとえばapplication_fee_amount、transfer_data、metadata、description、statement_descriptor など) の更新は保存されません。
PaymentIntent の元になる Charge オブジェクトには amount_updates 配列フィールドが含まれており、増分オーソリの結果がそこに追加されます。これは、オーソリの成否とその結果に関する詳細を示しています。
増分オーソリには上限があり、増分ごとに +50 USD (または現地通貨による相当額)、または前回のオーソリ金額の +50% のうち、いずれか高い方が上限となります。上限を引き上げたい場合は、サポートにお問い合わせください。
PaymentIntent をキャプチャーする
増分オーソリされた PaymentIntent のオーソリ済み金額を増やすかどうかにかかわらず、当初のオーソリの有効期限が切れる前に売上をキャプチャーする必要があります。増分オーソリでは有効期間は延長されません。過去に増分オーソリされた PaymentIntent のオーソリ済み金額をキャプチャーするには、通常と同様に capture エンドポイントを使用します。
curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \ -u
:sk_test_4eC39HqLyjWDarjtT1zdp7dc
増分オーソリが成功すると、更新された金額のキャプチャーされた PaymentIntent オブジェクトが返されますが、オーソリが失敗すると、代わりに card_declined エラーが返されます。その場合、PaymentIntent はキャプチャーされませんが、前にオーソリされた金額は引き続きキャプチャーできます。増分オーソリが失敗した場合、その他の PaymentIntent フィールド (たとえばapplication_fee_amount、transfer_data、metadata、description、statement_descriptor など) の更新は保存されません。
実装内容をテストする
Stripe の増分オーソリ用テストカードと任意のセキュリティコード、郵便番号、将来の日付の有効期限を使用して、テスト環境で増分オーソリをトリガーします。
まず、上記の PaymentIntent を作成して確定するステップで、テストカードを使用して PaymentIntent を作成します。
上記の増分オーソリを実行するステップで指定したパラメーターで増分オーソリを実行し、テストカードを使用して増分オーソリをトリガーします。
番号 | 決済手段 | 説明 |
---|---|---|
pm_card_debit_incrementalAuthAuthorized | これにより、オーソリ金額はリクエストで指定された金額に増額されます。 |