Mit Treasury und Issuing Finanzkonten und Karten einrichten

Folgen Sie dem Beispiel einer Treasury- und Issuing-Integration, die ein Finanzkonto einrichtet und Karten erstellt.

Homebox ist ein fiktives vertikales SaaS-Unternehmen, das Software für ein Unternehmen im Bereich haushaltsnaher Dienstleistungen entwickelt, wie etwa Heizungs- und Sanitärinstallateure, Reinigungskräfte und Gas-/Wasser-Installateure. Im Rahmen seiner Treasury-Integration richtet Homebox zuerst ein Treasury-Finanzkonto ein und erstellt die Zahlungskarten. In der Beispielintegration Mit Treasury Gelder übertragen erfahren Sie, wie Homebox Geldübertragungen auf und von externen Bankkonten durchführt.

Plattform-Onboarding

Homebox ist bereits eine Stripe-Plattform, bei der Payments und Connect aktiviert sind. Homebox verwendet nutzerdefinierte verbundene Konten, und für diese verbundenen Konten ist die Funktion card_payments bereits aktiviert.

Funktionen hinzufügen

Um Treasury und Issuing nutzen zu können, muss Homebox die zusätzlichen Funktionen treasury und card_issuing für die verbundenen Konten der Plattform anfordern. Alle verbundenen Konten müssen dann das Onboarding durchlaufen, bevor Stripe ein zugehöriges Treasury-Finanzkonto erstellen kann.

Um ACH-Überweisungen mit Treasury zu verwenden, muss Homebox außerdem die Funktion us_bank_account_ach_payments.

Um die Funktionen treasury, card_issuing und us_bank_account_ach_payments anzufordern, stellt Homebox eine Anfrage an die Accounts API.

Um das gehostete Onboarding zu verwenden, führt Homebox einen Account Links-Aufruf durch. Dadurch wird eine URL abgerufen, über die deren verbundene Konten Onboarding-Informationen für das Treasury-Finanzkonto übermitteln können.

Die Antwort darauf enthält eine URL, mit der verbundene Konten auf das Anmeldeformular zugreifen können. Dies muss vor Ablauf des Links geschehen.

{
  "object": "account_link",
  "created": 1612927106,
  "expires_at": 1612927406,
  "url": "https://connect.stripe.com/setup/s/iCtLfmYb2tEU"
}

Homebox hört den Webhook account.updated ab, um die folgenden Felder und Funktionen auf den verbundenen Konten zu bestätigen.

{
  "object": {
    "id": "{{CONNECTED_ACCOUNT_ID}}",
    "object": "account",
    "capabilities": {
      "card_payments": "active",
      "treasury": "active",
      "card_issuing": "active", // Only appears if requesting the `card_issuing` capability.
      "us_bank_account_ach_payments": "active", // Only appears if requesting the `us_bank_account_ach_payments` capability.
    },
    ...
  }
}

FinancialAccount erstellen

Sobald Stripe einem Konto die Funktion treasury hinzufügt, kann Homebox das FinancialAccount-Objekt für das Konto erstellen. Hierfür ruft Homebox FinancialAccounts auf und fordert die Features an, die das Unternehmen bereitstellen möchte.

Die Antwort bestätigt, dass das Konto bearbeitet wird. Nachdem die Verarbeitung abgeschlossen ist und alle relevanten Funktionen aktiviert wurden, erhält die Homebox eine Bestätigung vom Webhook-Listener treasury.financial_account.features_status_updated.

{
  "object": "treasury.financial_account",
  "created": 1612927106,
  "id": "{{FINANCIAL_ACCOUNT_ID}}",
  "country": "US",
  "supported_currencies": ["usd"],
  "financial_addresses": [ // This field is empty until the "financial_addresses.aba" feature becomes active
    {
      "type": "aba",
      "supported_networks": ["ach", "us_domestic_wire"],
      "aba": {
        "account_number_last4": "7890",
        // Use the expand[] parameter to view the `account_number` field hidden by default
        "account_number": "1234567890",
        "routing_number": "000000001",
        "bank_name": "Bank of Earth"
      }
    }
  ],
  "livemode": true,

  // State machine:
  // open - the account is ready to be used
  // closed - the account is closed
  "status": "open",
  "status_details": {
    // `closed` is null if financial account is not closed
    "closed": {
      // List of one or more reasons why the FinancialAccount was closed:
      // - account_rejected
      // - closed_by_platform
      // - other
      "reasons": [],
    }
  },

  active_features: ["card_issuing"],
  pending_features: ["deposit_insurance", "financial_addresses.aba", "outbound_payments.ach", "us_domestic_wire", "inbound_transfers.ach", "outbound_transfers.ach", "outbound_transfers.us_domestic_wire"],
  restricted_features: [],

  "features": {
    "object": "treasury.financial_account_features",
    "card_issuing": {
      "status": "active",
      "status_details": [],
      "access": "active",
    },
    "deposit_insurance": {
        "requested": true,
        "status": "pending", // Becomes "active" once the Treasury financial account is set up
        "status_details": [{"code": "activating", "resolution": nil}],
    },
    "financial_addresses": {
        "aba": {
            "requested": true,
            "status": "pending", // Becomes "active" once the Treasury financial account is set up
            "status_details": [{"code": "activating", "resolution": nil}],
        },
    },
    "outbound_payments": {
        "ach": {
            "requested": true,
            "status": "pending", // Becomes "active" once the Treasury financial account is set up
            "status_details": [{"code": "activating", "resolution": nil}],
        },
    },
    "us_domestic_wire": {
        "requested": true,
        "status": "pending", // Becomes "active" once the Treasury financial account is set up
        "status_details": [{"code": "activating", "resolution": nil}],
    },
    "inbound_transfers": {
        "ach": {
            "requested": true,
            "status": "pending", // Becomes "active" once the Treasury financial account is set up
            "status_details": [{"code": "activating", "resolution": nil}],
        },
    },
    "outbound_transfers": {
        "ach": {
            "requested": true,
            "status": "pending", // Becomes "active" once the Treasury financial account is set up
            "status_details": [{"code": "activating", "resolution": nil}],
        },
    },
    "outbound_payments": {
        "ach": {
            "requested": true,
            "status": "pending", // Becomes "active" once the Treasury financial account is set up
            "status_details": [{"code": "activating", "resolution": nil}],
        },
    },
    "outbound_transfers": {
        "us_domestic_wire": {
            "requested": true,
            "status": "pending", // Becomes "active" once the Treasury financial account is set up
            "status_details": [{"code": "activating", "resolution": nil}],
        },
    },
  "platform_restrictions": {
    "inbound_flows": "unrestricted",
    "outbound_flows": "unrestricted"
  },
 "metadata": {},
  ...
}

Zahlungskarteninhaber/in erstellen

Bevor Homebox Karten für Treasury-Finanzkonten erstellen kann, muss es zunächst Karteninhaber/innen anlegen. In diesem Beispiel handelt es sich dabei um Klempnerfirmen, die die Dienstleistungen von Homebox nutzen und denen die die verbundenen Konten der Plattform gehören.

Rufen Sie die Seite Verbundene Konten im Dashboard auf.
Wählen Sie das verbundene Konto aus, für das Sie eine/n Karteninhaber/in erstellen möchten, um dessen Details zu erweitern.
Wählen Sie die Registerkarte Kartenausstellung aus.
Klicken Sie auf die Schaltfläche + neben Karteninhaber/innen.
Geben Sie die Daten der Karteninhaberin/des Karteninhabers ein und klicken Sie auf Karteninhaber/in erstellen.

Zahlungskarten erstellen

Nachdem das verbundene Konto nun mit einem FinancialAccount-Objekt und einem/einer verfügbaren Karteninhaber/in verknüpft ist, kann Homebox eine Zahlungskarte mit dem Guthaben des FinancialAccount als verfügbarem Saldo der Karte erstellen.

Notiz

Sie können im Dashboard keine Finanzkonten erstellen. Sie müssen die API verwenden, um sie zu erstellen.

Rufen Sie die Seite Verbundene Konten im Dashboard auf.
Wählen Sie das verbundene Konto aus, für das Sie eine/n Karteninhaber/in erstellen möchten, um dessen Details zu erweitern.
Wählen Sie die Registerkarte Kartenausstellung aus.
Klicken Sie auf die Schaltfläche + neben Karten.
Wählen Sie den Kartentyp und das Finanzkonto aus, über das Sie die Karte aufladen möchten, und klicken Sie auf Erstellen.