Ihre Finanzkonto-Integration testen

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.

Umschalter für Test-Modus

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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d country=US \
  -d type=custom \
  -d business_type=company \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true \
  -d "capabilities[treasury][requested]"=true

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 mithilfe von POST /v1/treasury/financial_accounts ein Finanzkonto. Fügen Sie den Header Stripe-Account hinzu, welcher auf den Wert der ID des verbundenen Kontos festgelegt ist, die Sie in der vorherigen Anweisung erstellt haben. Im Text muss einzig supported_currencies[] auf usd gesetzt werden. Weitere Informationen zu Finanzkonten finden Sie unter Mit Finanzkonten arbeiten oder in der Objektbeschreibung FinancialAccounts in der Stripe API-Referenz.

curl https://api.stripe.com/v1/treasury/financial_accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Account: 
{{CONNECTED_ACCOUNT_ID}}
" \
  -d "supported_currencies[]"=usd \
  -d "features[financial_addresses][aba][requested]"=true

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.

curl https://api.stripe.com/v1/accounts/{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d "tos_acceptance[date]"=1547923073 \
  -d "tos_acceptance[ip]"="172.18.80.19" \
  -d "settings[treasury][tos_acceptance][date]"=1547923073 \
  -d "settings[treasury][tos_acceptance][ip]"="172.18.80.19" \
  -d "business_profile[mcc]"=5045 \
  --data-urlencode "business_profile[url]"="https://bestcookieco.com" \
  -d "company[address][city]"=Schenectady \
  -d "company[address][line1]"="123 State St" \
  -d "company[address][postal_code]"=12345 \
  -d "company[address][state]"=NY \
  -d "company[tax_id]"=000000000 \
  -d "company[name]"="The Best Cookie Co" \
  -d "company[phone]"=8888675309 \
  -d "individual[first_name]"=Jenny \
  -d "individual[last_name]"=Rosen