部分的オーソリ

利用可能な残高が全額に対応するには不足している場合に、カード取引のために最初にリクエストされた金額の一部に対する承認をリクエストするには、一部オーソリを使用します。これにより、顧客はカードの利用可能な残高 (デビットカードなど) を使い、別の決済手段を使用して残りの残高を支払うことができます。

はじめに

まず、当初リクエストされた金額のうち、一部オーソリでカバーされない部分の処理方法を決定します。別の支払い形式用に別の PaymentIntent を作成することも、PaymentIntent 全体をキャンセルすることも、または一部オーソリされた金額までに限定してキャプチャーすることもできます。取引をどのように処理するか、および潜在的な影響について、顧客に明確に伝えてください。

提供状況

一部オーソリには以下の制限があります。

• オンラインカード決済には、一部オーソリのみを使用できます。
• Visa、Mastercard、ディスカバー、Amex のみが一部オーソリに対応しています。
• カード発行会社とカードタイプによって、対応可能かどうかが決まります。
• ネットワークの制限により、取引金額が一部オーソリされている場合、オーソリした金額を超える金額をオーバーキャプチャーを使用してキャプチャーすることはできません。
• transfer_amount を使用して Connect アカウントに代わって支払いを処理する場合、transfer_amount が一部オーソリされた金額を上回ると、Stripe は一部オーソリされた金額に値を制限します。
• Stripe は、部分的にオーソリされた支払いに対して最小請求金額 を適用し、不足している PaymentIntent は拒否します。

手動キャプチャーを使って PaymentIntents を作成して確定する

特定の PaymentIntents に対して一部オーソリを有効にするには、request_partial_authorization パラメーターに if_available を設定します。

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=10000 \
  -d currency=usd \
  -d payment_method=pm_card_debit_partialAuthorization \
  -d "payment_method_types[]"=card \
  -d "payment_method_options[card][request_partial_authorization]"=if_available \
  -d capture_method=manual \
  -d confirm=true \
  -d "expand[]"=latest_charge

一部オーソリのステータスを確認する

PaymentIntent 確定レスポンスの latest_charge で、payment_method_details フィールドを確認して、ネットワークが支払いに一部オーソリを適用したかどうかを判断します。

• partial_authorization.status:partially_authorized、fully_authorized、declined、not_requested のいずれかのオーソリステータスを表示します。
• amount_requested:最初に指定したリクエスト金額を確認します。
• amount_authorized:オーソリされた金額を特定します。

以下のレスポンスの例は、最初にリクエストされた 100 USD よりも少ない 70 USD で、取引が一部オーソリされていることを示しています。

{
  "id": "pi_foo",
  "amount": 7000,
  "amount_capturable": 7000,
  "amount_received": 0,
  "capture_method": "manual",
  ...
  // if latest_charge is expanded
  "latest_charge": {
    "id": "ch_foo",
    "object": "charge",
    "amount": 7000,
    "captured": false,
    "payment_method_details": {
      "card": {
        "amount_authorized": 7000,
        "amount_requested": 10000,
        "partial_authorization": {
          "status": "partially_authorized",
        }
      }
    }
  },
  ...
  "status": "requires_capture"
}

カード発行会社がオーソリを拒否すると、このレスポンスで card_declined エラーが返されます。

一部オーソリされた PaymentIntent をキャプチャーする

確定レスポンスで返される amount (または amount_capturable) を上限として、オーソリされた PaymentIntent をキャプチャーできます。

curl -X POST https://api.stripe.com/v1/payment_intents/pi_foo/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

キャプチャーが成功すると、フィールドが更新された PaymentIntent (支払いインテント) オブジェクトが返されます。

{
  "id": "pi_foo",
  "amount": 7000,
  "amount_capturable": 0,
  "amount_received": 7000,
  "capture_method": "manual",
  "latest_charge": "ch_foo",
  ...
  "status": "succeeded",
}

構築したシステムをテストする

テスト時に一部オーソリをトリガーするには、一部オーソリ用の Stripe テストカードを、任意のセキュリティコード、郵便番号、および将来の有効期限とともに使用します。テストカードで一部オーソリをトリガーするには、必ず request_partial_authorization を if_available に設定してください。