> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swipelux.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Konten und Wallets

> Wählen Sie das kundeneigene Konto oder die ausgegebene Ressource, die für einen Geldfluss erforderlich ist.

Jedes Konto gehört zu einem Kunden. Wählen Sie es anhand zweier Dimensionen aus: wer es verwaltet und ob es eine Wallet oder ein Bankkonto ist.

## Ein Konto wählen

| Konto                  | Verwenden für                                                                                                                   |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Ausgegebene Wallet     | Verwahrten Stablecoin-Bestand halten, einen Payout finanzieren, ein Pay-in empfangen oder ein ausgegebenes Bankkonto abwickeln. |
| Ausgegebenes Bankkonto | Dem Kunden wiederverwendbare Bankdaten geben, die in eine ausgegebene Wallet abgewickelt werden.                                |
| Externe Wallet         | Eine Blockchain-Adresse aufzeichnen, die dem Kunden gehört.                                                                     |
| Externes Bankkonto     | Ein Bankkonto aufzeichnen, das dem Kunden für einen Erstpartei-Payout gehört.                                                   |

`issued` bedeutet, dass Swipelux die Ressource anlegt und verwaltet. `external` zeichnet einen Endpunkt auf, der dem Kunden gehört. Ein Drittparteien-Endpunkt gehört unter einen [Empfänger und Ziel](/de/integration/recipients), nicht in die Kontenliste des Kunden.

<h2 id="create-the-account">
  Das Konto anlegen
</h2>

Verwenden Sie [`POST /v3/customers/{customerId}/accounts`](/api-reference/accounts/post-v3-customers-by-customer-id-accounts). Senden Sie diese Header mit einem der unten stehenden Request-Bodies:

```http theme={null}
X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: account-create-001
Content-Type: application/json
```

<Tabs>
  <Tab title="Ausgegebene Wallet">
    ```json theme={null}
    {
      "origin": "issued",
      "type": "wallet",
      "currency": "USDC",
      "network": "base",
      "label": "Settlement wallet"
    }
    ```
  </Tab>

  <Tab title="Ausgegebenes Bankkonto">
    ```json theme={null}
    {
      "origin": "issued",
      "type": "bank",
      "method": "ach",
      "country": "US",
      "currency": "USD",
      "settlement": {
        "accountId": "${SETTLEMENT_WALLET_ID}"
      },
      "label": "USD account"
    }
    ```
  </Tab>

  <Tab title="Externe Wallet">
    ```json theme={null}
    {
      "origin": "external",
      "type": "wallet",
      "currency": "USDC",
      "network": "polygon",
      "details": {
        "address": "0x4997b0a68bebc1b0d80a93567ba7002be92b8b11"
      },
      "label": "Customer Polygon wallet"
    }
    ```
  </Tab>

  <Tab title="Externes Bankkonto">
    ```json theme={null}
    {
      "origin": "external",
      "type": "bank",
      "methods": ["ach", "wire"],
      "country": "US",
      "currency": "USD",
      "details": {
        "routingNumber": "021000021",
        "accountNumber": "123456789",
        "accountType": "checking",
        "bankName": "Example Bank",
        "accountHolderName": "Acme Payments SAS"
      },
      "label": "Customer operating account"
    }
    ```
  </Tab>
</Tabs>

Verwenden Sie nur Währungen, Netzwerke, Methoden und Kontotypen, die für den aktuellen Kunden und die Fähigkeit zurückgegeben wurden. Kopieren Sie die Verfügbarkeit nicht von einem anderen Kunden oder aus einer anderen Umgebung.

## Warten, bis das Konto nutzbar ist

Speichern Sie `data.id`, `data.status` und `data.openTaskIds` aus der Erstellungs-Antwort. Lesen Sie das aktuelle Konto mit [`GET /v3/customers/{customerId}/accounts/{accountId}`](/api-reference/accounts/get-v3-customers-by-customer-id-accounts-by-account-id), bevor Sie einen Transfer quotieren oder Bankdaten anzeigen.

Verwenden Sie das Konto nur, wenn sein aktueller Status die nächste Operation zulässt. Wenn Aufgaben-IDs offen sind, erledigen Sie sie über [Fähigkeiten und Aufgaben](/de/integration/onboarding/capabilities-and-requirements).

Ein ausgegebenes Bankkonto kann während der Bereitstellung `details: null` zurückgeben. Zeigen Sie Bankdaten erst an, nachdem eine aktuelle Leseoperation den vollständigen Satz zurückgibt. Wenn `details.referenceRequired` true ist, zeigen Sie die genaue `details.reference` mit den Bankkoordinaten an.

## Kontenrollen explizit halten

Für einen Payout ist die ausgegebene Wallet die Quelle in `in.accountId`. Ein kundeneigenes Bankkonto ist die `destinationId`. Für ein ausgegebenes Bankkonto ist `settlement.accountId` die ausgegebene Wallet, die passende Einzahlungen empfängt.

Verwenden Sie als Nächstes ein bereites Konto in [Gelder empfangen](/de/integration/receive-funds), [Gelder senden](/de/integration/send-funds) oder [Bankkonto ausgeben](/de/integration/issue-bank-account).


## Related topics

- [Bankkonto ausgeben](/de/integration/issue-bank-account.md)
- [Wallet-Architektur und Auszahlungen](/de/knowledge-base/compliance/custody-and-wallet-controls.md)
- [Migration zu v3](/de/api-reference/versioning/migrate-to-v3.md)
- [Übersicht](/de/knowledge-base/compliance/overview.md)
- [Allgemeine Informationen](/de/knowledge-base/compliance/regulatory-perimeter.md)
