> ## 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.

# Kunden

> Erstellen Sie die Einzelperson oder das Unternehmen, dem Fähigkeiten, Konten und Transfers gehören.

Legen Sie den Kunden an, bevor Sie ein Pay-in, einen Payout oder ein ausgegebenes Bankkonto aufbauen. Fähigkeiten, Konten und Transfers sind auf diesen Kunden bezogen. Verwenden Sie `externalId` als stabile Zuordnung zum entsprechenden Datensatz in Ihrem System.

```bash theme={null}
export API_BASE='https://platform.swipelux.com'
export SWIPELUX_API_KEY='replace-with-your-api-key'
```

<h2 id="individual-customers">
  Einzelpersonen-Kunden
</h2>

Eine Einzelperson benötigt nur `type`. Fügen Sie Profildaten hinzu, die Sie bereits kennen, und ergänzen Sie weitere nur, wenn die aktuelle Fähigkeit oder Aufgabe sie erfordert.

Legen Sie den Kunden mit [`POST /v3/customers`](/api-reference/customers/post-v3-customers) an:

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: customer-user-123" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "type": "individual",
  "externalId": "user_123",
  "individual": {
    "firstName": "Amina",
    "lastName": "Diallo",
    "residenceCountry": "FR"
  }
}
JSON
```

Speichern Sie die zurückgegebene `data.id` als `CUSTOMER_ID`. Siehe [Onboarding von Einzelpersonen](/de/knowledge-base/individual-onboarding/overview) für den Richtlinienkontext.

<h2 id="business-customers">
  Unternehmens-Kunden
</h2>

Ein Unternehmen benötigt `business.legalName`. Legen Sie das Unternehmen mit derselben Operation an:

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: customer-company-456" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "type": "business",
  "externalId": "company_456",
  "business": {
    "legalName": "Acme Payments SAS"
  }
}
JSON
```

Speichern Sie die zurückgegebene `data.id` als `CUSTOMER_ID`. Siehe [Unternehmens-Onboarding](/de/knowledge-base/business-onboarding/overview) für Richtlinien- und Dokumentenkontext.

## Verbundene Parteien für Unternehmen hinzufügen

Fügen Sie Direktoren, Eigentümer und andere Unternehmensbeteiligte hinzu, wenn sie bekannt oder angefordert sind. Dieses Beispiel legt einen Direktor mit [`POST /v3/customers/{customerId}/related-parties`](/api-reference/customers/post-v3-customers-by-customer-id-related-parties) an:

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/related-parties" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: related-party-director-001" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "partyType": "person",
  "roles": ["director"],
  "title": "Chief executive officer",
  "person": {
    "firstName": "Amina",
    "lastName": "Diallo",
    "residenceCountry": "FR"
  }
}
JSON
```

Speichern Sie die zurückgegebene `data.id` als `RELATED_PARTY_ID`.

## Bereitschaft aus Fähigkeiten lesen

Ein Kunde hat in der API keinen Verifizierungs- oder Bereitschaftsstatus. Lesen Sie den Kunden mit [`GET /v3/customers/{customerId}`](/api-reference/customers/get-v3-customers-by-customer-id) für aktuelle Profildaten und verwenden Sie dann Fähigkeiten und deren `openTaskIds`, um zu entscheiden, was der Kunde als Nächstes tun kann.

```bash theme={null}
curl --request GET \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}"
```

Fahren Sie als Nächstes mit [Fähigkeiten und Aufgaben](/de/integration/onboarding/capabilities-and-requirements) fort, um das benötigte Produktergebnis zu entdecken und zu aktivieren.


## Related topics

- [Migration zu v3](/de/api-reference/versioning/migrate-to-v3.md)
- [Quickstart](/de/integration/quickstart.md)
- [Konten und Wallets](/de/integration/accounts.md)
- [Fähigkeiten und Aufgaben](/de/integration/onboarding/capabilities-and-requirements.md)
- [API-Workflow für Einzelpersonen-Onboarding](/de/knowledge-base/individual-onboarding/api-workflow.md)