Migrationsleitfaden für Beta-Header

So migrieren Sie vom API-Beta-Header für BECS-Lastschriftverfahren in Neuseeland.

Das BECS-Lastschriftverfahren in Neuseeland wird allgemein verfügbar. Wir müssen die Beta-Nutzer/innen bitten, den Beta-Header der API nicht mehr zu übergeben. In diesem Leitfaden werden die für die Migration erforderlichen Änderungen erläutert.

Schritt 1: Stripe.js – Änderungen ab 31. März 2025

Am 31. März 2025 wird Stripe den Veröffentlichungszyklus von stripe.js aktualisieren. Derzeit haben wir nur eine Version von stripe.js, nämlich v3. Dies ändert sich gerade, und stattdessen wird stripe.js einem monatlichen Release-Zyklus folgen, der auf den API-Versions-Zyklus abgestimmt ist.

Jede monatliche Veröffentlichung von stripe.js ist an die monatliche API-Version gebunden, die zur gleichen Zeit veröffentlicht wird. Beispielsweise nutzt Version 2025-03-31.basil von stripe.js die Version 2025-03-31.basil der API.

Das bedeutet auch, dass Sie keine API-Beta-Header mehr übergeben können, wenn Sie stripe.js initialisieren.

Erforderliche Änderungen

Wenn Sie stripe.js v3 verwenden, müssen Sie sowohl das Front-End-Beta-Flag nz_bank_account_beta_2 als auch den API-Beta-Header nz_bank_account_beta=v2 übergeben.

Wenn Sie ein Upgrade auf stripe.js, Version 2025-03-31.basil durchführen, müssen Sie aufhören, sowohl das Front-End-Beta-Flag als auch den API-Beta-Header zu übergeben.

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

Schritt 2: API und SDK – Änderungen bis zum 30. Juni 2025 erforderlich

Am 31. März 2025 gibt Stripe die Zahlungsmethode 2025-03-31.basil in der API-Versionnz_bank_account zur allgemeinen Verfügbarkeit frei.

Das bedeutet, dass die Übergabe des Beta-Headers der API für den Zugriff auf die Zahlungsmethode nz_bank_account nicht mehr erforderlich ist.

Stripe möchte, dass Beta-Nutzer/innen die Übergabe des Beta-Headers bis zum 30. Juni 2025 einstellen.

Erforderliche Änderungen

Sie müssen die Übergabe des Beta-Headers in allen Anfragen an alle Endpoints – /v1/payment_intents, /v1/setup_intents, /v1/checkout/sessions, /v1/customers, usw – beenden.

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