支払い方法を保留する

When you create a payment, you can place a hold on an eligible payment method to reserve funds that you can capture later. For example, hotels often authorize a payment in full before a guest arrives, then capture the money when the guest checks out. This is sometimes referred to as manual capture.

決済のオーソリにより、顧客の支払い方法で金額が確保されて保証されます。API を使用している場合、支払いの payment_method_details.card.capture_before 属性は、オーソリの有効期限が切れる日時を示します。

You need to capture the funds before the authorization expires. If the authorization expires before you capture the funds, the funds are released and the payment status changes to canceled. Learn more about statuses for asynchronous payments.

Authorization validity windows

The following tables outline validity windows for authorizing different transaction types.

Card-not-present transactions

Card-present transactions (in-person payments)

30-day authorization windows in Japan

If your account is based in Japan, you can hold JPY-denominated transactions from Visa, Mastercard, JCB, Diners Club, and Discover for up to 30 days. Non-JPY and American Express transactions expire after the standard 7-day window.

Payment method limitations

導入前に、オーソリとキャプチャーの分離に関する次の制限事項を確認してください。

• Only some payment methods support separate authorization and capture. Some payment methods that support this include cards, Affirm, Afterpay, Cash App Pay, Klarna, and PayPal. Some payment methods that don’t support this include ACH and iDEAL. Read more about payment method feature support.

• 上の表に記載されている以外にも、他の支払い方法には、さまざまな規則とオーソリ期間が適用されます。

  • カード支払い: 通常、オンライン決済で 7 日間、対面の Terminal 決済で 2 日間、金額が保留されます (取引のタイプとカードネットワークに応じて異なります)。有効期間延長の対象となる一部のオンライン決済および Terminal 決済のオーソリについては、オーソリの延長をリクエストすることができます。また、カードネットワークはキャプチャーを意図しない 1 USD のオーソリを禁止する可能性があります。
  • Affirm: Affirm で非常に高額の注文額に対して頭金が必要な場合、オーソリ時にその金額が請求され、支払いがキャプチャーされなかった場合は返金されます。その後は、30 日以内に支払い残高をキャプチャーしてください。
  • Afterpay / Clearpay: オーソリ中に、顧客は初回の分割返済を行います。Afterpay は、キャプチャーされなかった支払いを返金します。その後、13 日以内に支払い残高をキャプチャーする必要があります。
  • Cash App Pay: 支払いを完了するには、有効なオーソリを 7 日以内にキャプチャーする必要があります。
  • Klarna: 支払いは、支払いリクエスト日から 28 日後の午前 0 時までにキャプチャーする必要があります。それまでにキャプチャーしないとオーソリは期限切れになります。たとえば、2020 年 10 月 1 日 14:00 (UTC) の支払いリクエストは、2020 年 10 月 29 日 00:00 (UTC) までにキャプチャーする必要があります。
  • PayPal: 金額は 10 日間保留されます。Stripe は、さらに 10 日間 (合計 20 日間) の保留の延長を自動的に試行します。売上処理の設定がオーソリ期間に影響する場合があります。詳細については、オーソリとキャプチャーの分離をご覧ください。

Use the Dashboard to authorize and capture

コードを記述せずに、支払いのオーソリと売上のキャプチャーを別々に行うことができます。

1. ダッシュボードで新しい支払いを作成し、1 回限りを選択します。
2. 支払い方法を入力または選択する際に、その他のオプション を選択して、売上を後でキャプチャーを選びます。

支払いは、支払いページに未キャプチャーとして表示されます。

売上をキャプチャーするには、支払いの詳細ページに移動してキャプチャーをクリックします。

Tell Stripe to authorize only

オーソリとキャプチャーを分離することを示すには、PaymentIntent の作成時に、capture_method に manual を指定します。このパラメーターは、Stripe に対して、金額のオーソリのみを行い、顧客の支払い方法でキャプチャーしないよう指示します。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d capture_method=manual

With the above approach, you tell Stripe that you can only use “capture after” for a PaymentIntent with eligible payment methods. For example, you can’t accept card payments and SEPA Direct Debit (which doesn’t support capture after) for a single PaymentIntent. To accept payment methods that might not all support capture after, you can configure capture-after-per-payment-method by configuring capture_method=manual on the payment_method_options[<payment_method_type>] object.

For example, by configuring payment_method_options[card][capture_method]=manual, you’re placing only card payments on hold. You can manage payment methods from the Dashboard. Stripe handles the logic for dynamically displaying the most relevant eligible payment methods to each customer based on factors such as the transaction’s amount, currency, and payment flow.

{ % codegen-snippet path=“/v1/payment_intents” method=“POST” args={ “amount”: 1099, “currency”: $merchant.currency, “automatic_payment_methods”: { “enabled”: true }, “payment_method_options”: { “card”: { “capture_method”: “manual” } } } /%}

Alternatively, you can list card and sepa_debit using payment method types like in the example below.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=card \
  -d "payment_method_types[]"=sepa_debit \
  -d "payment_method_options[card][capture_method]"=manual

引き続きキャプチャーを行う前に、カード詳細による支払い方法を PaymentIntent に関連付け、PaymentIntent を確定してカードをオーソリします。これを行うには、PaymentIntent で payment_method フィールドと confirm フィールドを設定します。

Capture the funds

支払い方法のオーソリが完了すると、PaymentIntent のステータスは requires_capture に移行します。オーソリ済みの売上をキャプチャーするには、PaymentIntent のキャプチャーリクエストを行います。デフォルトでは、オーソリ済みの総額がキャプチャーされます。当初の金額より少ない、または (特定のオンラインカード決済に対して) 多い金額をキャプチャーするには、amount_to_capture オプションを渡します。部分的なキャプチャーを行った場合、残額は自動的にリリースされます。オンラインカード決済に対して当初より多い金額をキャプチャーする場合は、オーバーキャプチャーに関するドキュメントで詳細をご確認ください。

次の例は、オーソリ済みの 10.99 USD の支払いのうち、7.50 USD をキャプチャーする方法を示しています。

curl https://api.stripe.com/v1/payment_intents/pi_123/capture \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d amount_to_capture=750

Although some card payments are eligible for multicapture, you can only perform one capture on an authorized payment for most payments. If you partially capture a payment, you can’t perform another capture for the difference. (Instead, consider saving the customer’s payment method details for later and creating future payments as needed.)

カード発行会社および支払い方法のインターフェイスによっては、カード明細書でオーソリとキャプチャー (売上処理) された支払いが区別されておらず、顧客の混乱を招くことがあります。

さらに、顧客が手動キャプチャーによって PaymentIntent 上で支払い処理を完了すると、payment_intent.amount_capturable_updated イベントがトリガーされます。PaymentIntent からキャプチャー可能な合計額を確認するには、PaymentIntent の amount_capturable プロパティを調べます。

Cancel the authorization

オーソリをキャンセルする必要がある場合は、PaymentIntent をキャンセルしてください。