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

# Ügyfelek

> Hozza létre azt a magánszemélyt vagy vállalkozást, amely a képességekhez, számlákhoz és átutalásokhoz tartozik.

Hozza létre az ügyfelet, mielőtt pénzbefizetést, kifizetést vagy kibocsátott bankszámlát épít. A képességek, számlák és átutalások az adott ügyfélhez tartoznak. Az `externalId` használatával stabil hozzárendelést tehet a rendszerében lévő rekordhoz.

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

<h2 id="individual-customers">
  Magánszemély ügyfelek
</h2>

Egy magánszemélyhez csak a `type` szükséges. Adja hozzá a már ismert profilmezőket, és csak akkor tegyen hozzá többet, ha az aktuális képességnek vagy feladatnak szüksége van rájuk.

Hozza létre az ügyfelet a [`POST /v3/customers`](/api-reference/customers/post-v3-customers) művelettel:

```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
```

Tárolja a visszakapott `data.id` értéket `CUSTOMER_ID`-ként. A szabályzati kontextushoz lásd a [Magánszemély onboarding](/hu/knowledge-base/individual-onboarding/overview) oldalt.

<h2 id="business-customers">
  Üzleti ügyfelek
</h2>

Az üzleti ügyfélhez a `business.legalName` szükséges. Hozza létre a vállalkozást ugyanazzal a művelettel:

```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
```

Tárolja a visszakapott `data.id` értéket `CUSTOMER_ID`-ként. A szabályzati és dokumentum-kontextushoz lásd az [Üzleti onboarding](/hu/knowledge-base/business-onboarding/overview) oldalt.

## Üzleti kapcsolt felek hozzáadása

Adja hozzá az igazgatókat, tulajdonosokat és egyéb üzleti résztvevőket, ha ismertek vagy kértek. Ez a példa egy igazgatót hoz létre a [`POST /v3/customers/{customerId}/related-parties`](/api-reference/customers/post-v3-customers-by-customer-id-related-parties) művelettel:

```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
```

Tárolja a visszakapott `data.id` értéket `RELATED_PARTY_ID`-ként.

## Készenlét olvasása képességekből

Az ügyfélnek nincs ellenőrzési vagy készenléti státusza az API-ban. Olvassa be az ügyfelet a [`GET /v3/customers/{customerId}`](/api-reference/customers/get-v3-customers-by-customer-id) művelettel az aktuális profiladatokért, majd használja a képességeket és azok `openTaskIds` értékeit annak eldöntéséhez, hogy az ügyfél mit tehet legközelebb.

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

Ezután folytassa a [Képességek és feladatok](/hu/integration/onboarding/capabilities-and-requirements) oldalon a szükséges termékeredmény felfedezéséhez és aktiválásához.


## Related topics

- [Migrálás v3-ra](/hu/api-reference/versioning/migrate-to-v3.md)
- [Tranzakciós limitek](/hu/knowledge-base/compliance/transaction-limits.md)
- [Képességek és feladatok](/hu/integration/onboarding/capabilities-and-requirements.md)
- [Magánszemély onboarding áttekintése](/hu/knowledge-base/individual-onboarding/overview.md)