Weiter zum Inhalt
Konto erstellen
oder
anmelden
Das Logo der Stripe-Dokumentation
/
KI fragen
Konto erstellen
Anmelden
Jetzt starten
Zahlungen
Umsatz
Plattformen und Marktplätze
Geldmanagement
Entwickler-Tools
Übersicht
Versionierung
Änderungsprotokoll
    Übersicht
    Basilikum
    Acacia
    Vorherige Versionen
Aktualisieren Sie Ihre API-Version
Ihre SDK-Version aktualisieren
Entwickler-Tools
SDKs
API
Tests
Workbench
Ereignisziele
Arbeitsabläufe
Stripe-CLI
Stripe Shell
Entwickler-Dashboard
Agent-Toolkit
Mit LLMs entwickelnStripe für Visual Studio CodeStripe-StatuswarnungenHochgeladene Dateien
Sicherheit und Datenschutz
Sicherheit
Datenschutz
Extend Stripe
Stripe-Apps
Stripe Connectors
Partner
Partner-Ecosystem
Partner-Zertifizierung
StartseiteEntwickler-ToolsChangelogBasil2025-03-31.basil

Fügt neue Fehlercodes für erforderliche Verifizierungen hinzuWichtige Änderungen

Das ändert sich

Fügt dem Array requirements.errors in der Accounts API, Capabilities API, Persons API und Bank Accounts API folgende Fehlercodes hinzu.

  • information_missing
  • invalid_signator
  • verification_failed_authorizer_authority
  • verification_rejected_ownership_exemption_reason

Der Fehlercode information_missing ist allgemeiner als frühere Fehlercodes. Verwenden Sie die verknüpften Felder requirement and reason, um zu erfahren, welche Informationen fehlen. Für einige Konten in Singapur wird beispielsweise Folgendes angezeigt:

// GET /v1/accounts/{{CONNECTED_ACCOUNT_ID}} { ... "requirements": { "currently_due": ["documents.proof_of_ultimate_beneficial_ownership.files"], "errors": [ { "code": "information_missing", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "reason": "We identified that your business is owned by holding companies that require additional information to be collected. Please provide documents that include information for each applicable holding company. For more information, see https://support.stripe.com/questions/beneficial-ownership-verification-for-holding-companies. The new holding companies we have identified are: ACME INC." } ], ... }, ... }

Wir geben den Fehler invalid_signator zurück, wenn Sie ein Bescheinigungsschreiben als Nachweis für die letztendliche wirtschaftliche Eigentümerschaft hochgeladen haben und wir die Berufsorganisation, die das Dokument notariell beglaubigt hat, nicht verifizieren konnten.

{ ... "requirements": { "currently_due": ["documents.proof_of_ultimate_beneficial_ownership.files"], "errors": [ { "code": "invalid_signator", "requirement": "documents.proof_of_ultimate_beneficial_ownership.files", "reason": "We could not verify the professional certifying body of this document." } ], ... }, ... }

Wir geben den Fehler verification_failed_authorizer_authority zurück, wenn Sie eine Person als Autorisierer/in für Ihr Konto festgelegt haben und wir diese Autoritätsposition in Ihrem Unternehmen nicht verifizieren konnten. Weitere Informationen finden Sie unter ÜVerifizierung der Vertreterautorität.

{ ... "requirements": { "currently_due": ["{{AUTHORIZER_PERSON_TOKEN}}.relationship.authorizer"], "errors": [ { "code": "verification_failed_authorizer_authority", "requirement": "{{AUTHORIZER_PERSON_TOKEN}}.relationship.authorizer", "reason": "The authority of the authorizer could not be verified. Authorizers must be one of Director, Chief Executive Officer listed on acra.gov.sg." } ], ... }, ... }

Wir geben den Fehler verification_rejected_ownership_exemption_reason zurück, wenn Sie eine Ausnahme für die Bereitstellung Ihrer letztendlichen wirtschaftlichen Eigentumsverhältnisse eingereicht haben, und wir die Ausnahme abgelehnt haben.

{ ... "requirements": { "currently_due": ["documents.proof_of_ultimate_beneficial_ownership.files"], "alternatives": [ { "original_fields_due": ["documents.proof_of_ultimate_beneficial_ownership.files"], "alternative_fields_due": ["company.ownership_exemption_reason"], } ], "errors": [ { "code": "verification_rejected_ownership_exemption_reason", "requirement": "company.ownership_exemption_reason", "reason": "The ownership exemption reason was rejected." } ], ... }, ... }

Warum ist dies eine wichtige Änderung?

Einige Connect-Integrationen erfordern möglicherweise ein Update, um die neuen Fehlercodes zu verarbeiten.

Ergebnis

Sie können neue Fehlercodes für die anstehenden Aktualisierungen der Anforderungen in Singapur verarbeiten.

Änderungen

WerteÄndernAufzählungen
information_missinginvalid_signatorverification_failed_authorizer_authorityverification_rejected_ownership_exemption_reasonHinzugefügt
Account.future_requirements.errors[].codeAccount.requirements.errors[].codeBankAccount.future_requirements.errors[].code
 + 5 weitere
BankAccount.requirements.errors[].codeCapability.future_requirements.errors[].codeCapability.requirements.errors[].codePerson.future_requirements.errors[].codePerson.requirements.errors[].code

Upgrade

  1. Zeigen Sie Ihre aktuelle API-Version in Workbench an.
  2. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version.
    • Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre API-Anfragen auf Stripe-Version: 2025-03-31.basil
  3. Aktualisieren Sie die für Webhook-Endpoints verwendete API-Version.
  4. Testen Sie Ihre Integration mit der neuen Version.
  5. Wenn Sie Connect verwenden, testen Sie Ihre Connect-Integration.
  6. Führen Sie das Upgrade in Workbench durch. Sie können die Version für 72 Stunden zurücksetzen.

Erfahren Sie mehr über Stripe-API-Upgrades.

War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unser Änderungsprotokoll an.
Fragen? Sales-Team kontaktieren.
LLM? Lesen Sie llms.txt.
Unterstützt von Markdoc