ベータヘッダー移行ガイド

ニュージーランドの BECS ダイレクトデビットの API ベータヘッダーから移行する方法。

ニュージーランドの BECS ダイレクトデビットが一般提供される予定です。ベータユーザーでの、API ベータヘッダーの受け渡しを停止する必要があります。このガイドでは、移行に必要な変更について説明します。

ステップ 1 - stripe.js - 2025 年 3 月 31 日に予定されている変更

2025 年 3 月 31 日に、Stripe は stripe.js のリリースサイクルを更新します。現在、stripe.js のバージョンは v3 の 1 つだけです。これは変更されており、代わりに stripe.js API リリースサイクルに合わせて毎月のリリースサイクルに従います。

stripe.js の各月次リリースは、同時に送信される月次 API リリースに関連付けられています。たとえば、バージョン 2025-03-31.basil の stripe.js では、バージョン 2025-03-31.basil の API が使用されます。

これは、stripe.js を初期化するときに API ベータヘッダーを渡すことができなくなることも意味します。

必要な変更

stripe.js v3 を使用する場合は、nz_bank_account_beta_2 フロントエンドのベータフラグと nz_bank_account_beta=v2 API ベータヘッダーの両方を渡す必要があります。

「stripe.js バージョン 2025-03-31.basil にアップグレードするときは、フロントエンドのベータフラグと API ベータヘッダーの両方を渡すのを停止する必要があります。」

checkout.js
const stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx', {
  betas: ['nz_bank_account_beta_2'],
  apiVersion: "2025-04-30.basil;nz_bank_account_beta=v2"
});

ステップ 2 - API と SDK - 2025 年 6 月 30 日までに変更が必要

2025 年 3 月 31 日に、2025-03-31.basil API バージョンのリリースで、Stripe は nz_bank_account 決済手段を一般公開します。

つまり、nz_bank_account の決済手段にアクセスするために API ベータヘッダーを渡す必要がなくなりました。

Stripe は、2025 年 6 月 30 日までにベータユーザーによるベータヘッダーの受け渡しを停止します。

必要な変更

すべてのエンドポイント (/v1/payment_intents、/v1/setup_intents、/v1/checkout/sessions、/v1/customers など) へのすべての要求でベータヘッダーの受け渡しを停止する必要があります

Command Line
curl https://api.stripe.com/v1/payment_intents \
-u sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
-H "Stripe-Version: 2025-04-30.basil;nz_bank_account_beta=v2"
-d amount=1099 \
-d currency=eur