Ihre Finanzkonto-Integration testen

So sorgen Sie dafür, dass Ihre Finanzkonten ordnungsgemäß funktionieren.

Stripe Treasury enthält einen Live-Modus und einen Test-Modus. Mithilfe des Modusumschalters oben rechts können Sie von Ihrem Dashboard aus zwischen den Modi hin- und herschalten.

Obere Ecke des Dashboards mit einem roten Feld, das die Umschaltfunktion für den Test-Modus hervorhebt.

Umschalter für Test-Modus

Notiz

Sie müssen die Schritte im Live-Modus im Leitfaden API-Zugriff auf Treasury ausführen, bevor Sie Zugriff auf Finanzkonten im Live-Modus erhalten.

Um auf den Test-Modus in der API zuzugreifen, verwenden Sie für Ihre Anfragen den API-Schlüssel im Test-Modus. Dieser Schlüssel ist in den meisten Codebeispielen in der Dokumentation enthalten, Sie finden ihn aber auch auf der Seite Entwickler/innen Ihres Dashboards. Achten Sie darauf, zum Testen den Testschlüssel verwenden und nicht den Live-Schlüssel. Der Testschlüssel weist die Form sk_test_xxx, der Live-Schlüssel die Form sk_live_xxx.

Richten Sie vor Erstellen eines Test-Finanzkontos mithilfe von POST /v1/accounts ein verbundenes Testkonto ein. Verwenden Sie die ID des verbundenen Kontos, die Sie aus der Antwort erhalten, um das Finanzkonto, das Sie im nächsten Schritt erstellen, diesem Konto zuzuordnen. Treasury wird nur in den USA unterstützt, also müssen Sie dem Parameter country US zuweisen. Sie fordern auch Funktionen für das verbundene Konto an, die Treasury benötigt, um ordnungsgemäß zu funktionieren. Notieren Sie sich den id-Wert in der Antwort. Wie bereits erwähnt wird die ID als Wert für die Stripe-Account-Kopfzeile im folgenden Codebeispiel verwendet.

Bei Erfolg gibt die Antwort das Account-Objekt des neuen verbundenen Kontos zurück.

{
  "id": "{{CUSTOM_ACCOUNT_ID}}",
  "livemode": false,
  ...
}

Erstellen Sie als Nächstes ein Finanzkonto mitPOST /v1/treasury/financial_accounts. Fügen Sie einen Stripe-Konto-Header ein, der auf den Wert der ID des verbundenen Kontos gesetzt ist, die Sie in der vorherigen Anweisung erstellt haben. Der einzige erforderliche Wert im Hauptteil ist das Festlegen der supported_currencies[] auf usd. Weitere Informationen zu Finanzkonten finden Sie unterArbeiten mit Finanzkonten oder in der FinancialAccounts- Objektbeschreibung in der Stripe API-Dokumentation.

Bei Erfolg gibt die Antwort das neu erstellte FinancialAccount-Objekt zurück.

{
  "id": "{{FINANCIAL_ACCOUNT_ID}}",
  "livemode": false,
  "active_features": [],
  "pending_features": [],
  "restricted_features": ["financial_addresses.aba"],
  ...
}

Sie haben jetzt ein Finanzkonto im Test-Modus, das an ein verbundenes Konto im Test-Modus angehängt ist. Das verbundene Konto hat jedoch kein Onboarding durchlaufen, sodass erforderliche Angaben im requirements-Hash fehlen. Wenn Sie GET /v1/treasury/financial_accounts/{{FINANCIAL_ACCOUNT_ID}} mithilfe der Finanzkonto-ID in der JSON-Antwort der vorherigen Anweisung aufrufen, sehen Sie, dass das Hash-Array financial_addresses einen Eintrag für das angeforderte aba mit dem status restricted enthält, weil das verbundene Konto requirements_past_due aufweist.

{
  …
  "financial_addresses": {
    "aba": {
      "requested": true,
      "status": "restricted",
      "status_details": [
        {
          "code": "requirements_past_due",
          "resolution": "provide_information"
        }
      ]
    }
  }
  …
}

Um die angeforderten Funktionen auf Ihrem Finanzkonto im Test-Modus zu aktivieren, ohne zuerst das Onboarding verbundener Konten zu durchlaufen, müssen Sie POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} verwenden. So stellen Sie Testwerte bereit, die, wie die folgende Anfrage, alle Anforderungen erfüllen und die erforderlichen Kontodetails mithilfe eines zuvor erstellten verbundenen Kontos anwenden.

Notiz

Sie können kein Finanzkonto im Testmodus erstellen, das einem verbundenen Konto im Live-Modus hinzugefügt wurde.