最新の柔軟な支払いシナリオに対応する

ベータ版の高度な決済シナリオを一般リリース版に適応させます。

Stripe では、カード非提示取引に対していくつかの柔軟な決済シナリオをサポートするようになりました。すでにこれらの機能のプライベートベータ版を実装している場合は、このガイドで一般リリース版への詳しいアップグレード方法をご確認ください。新しく実装する場合は、以下のガイドでご興味のある機能をご確認ください。

Stripe では、これらの機能に対してフィードバックに基づいた以下の改善を行いました。

PaymentIntent レベルでの機能の詳細なコントロール。
確定フェーズ後の機能の利用可能状況と使用量に関する明確な予測。

柔軟な決済の各機能には、プライベートベータ実装とは異なる要件があります。アップグレードが必要な機能を選択し、上部の注釈でその機能に固有の変更点と要件を参照してください。

ベータからの変更点

この実装の最初のステップは必須になりました。

増分オーソリをリクエストする

確定前に PaymentIntent に増分オーソリのリクエストを含める必要があります。

警告

このステップは以前はオプションでしたが、現在は必須になりました。

前

後

レスポンスでは、latest_charge の payment_method_details.card.incremental_authorization.status プロパティに増分オーソリリクエストのステータスが返されるようになりました。ステータスの値は、顧客の支払い方法に応じて available または 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_supported": true // or false
          }
        }
        ...
      }
  }
}

// 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"
            }
          }
        }
        ...
      }
  }
}

オーソリ額を段階的に変更する

このステップにはベータ版からの変更はありません。

最初のオーソリ額を超える金額をキャプチャーする方法を選択する

次の 2 つの柔軟な決済で、最初のオーソリ額を超える金額をキャプチャーすることができます。

一定の限度額までオーバーキャプチャーする (支払いでオーソリ額を超える金額をキャプチャーする)
既存のオーソリを増額し、その後新しいオーソリ額をキャプチャーする (オーソリを増額する)

以下の例では、これらの機能が一般提供版でどのように補完し合うかを示しています。

// PaymentIntent Response
{
  "object": "payment_intent",
  "amount": 1000,
  ...
  // if latest_charge is expanded
  {
    "latest_charge": {
      "payment_method_details": {
        "card": {
          "incremental_authorization": {
              "status": "available" // or "unavailable"
          },
          "overcapture": {
              "status": "available", // or "unavailable"
              "maximum_capturable_amount": 1200
          }
        }
      }
      ...
    }
  }
}

PaymentIntent の確定時に両方の機能を利用できる場合、次のステップで最初にオーソリ額を超える金額をキャプチャーするには、次のオプションがあります。

希望金額が maximum_capturable_amount 以下の場合はオーバーキャプチャーします。
希望金額に対する増分オーソリを実行し、その後キャプチャーします。