Kunder

Opprett kunden før du bygger en pay-in, payout eller utstedt bankkonto. Capabilities, kontoer og overføringer er avgrenset til denne kunden. Bruk externalId som stabil kobling til den tilhørende oppføringen i ditt system.

export API_BASE='https://platform.swipelux.com'
export SWIPELUX_API_KEY='replace-with-your-api-key'

Individkunder

En individkunde krever kun type. Inkluder profilfelter du allerede kjenner, og legg til flere kun når gjeldende capability eller oppgave trenger dem. Opprett kunden med POST /v3/customers:

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

Lagre den returnerte data.id som CUSTOMER_ID. Se Individonboarding for policykontekst.

Virksomhetskunder

En virksomhet krever business.legalName. Opprett virksomheten med samme operasjon:

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

Lagre den returnerte data.id som CUSTOMER_ID. Se Virksomhetsonboarding for policy- og dokumentkontekst.

Legg til nærstående parter for virksomheten

Legg til styremedlemmer, eiere og andre deltakere i virksomheten når de er kjent eller etterspurt. Dette eksempelet oppretter et styremedlem med POST /v3/customers/{customerId}/related-parties:

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

Lagre den returnerte data.id som RELATED_PARTY_ID.

Les klarhet fra capabilities

En kunde har ikke en verifiserings- eller klarhetsstatus i API-et. Les kunden med GET /v3/customers/{customerId} for gjeldende profildata, og bruk deretter capabilities og deres openTaskIds for å avgjøre hva kunden kan gjøre videre.

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

Deretter, fortsett til Capabilities og oppgaver for å oppdage og aktivere produktutfallet du trenger.

Kom i gang

Kundeombording

Bygg pengestrømmer

Lansering

Individkunder

Virksomhetskunder

Legg til nærstående parter for virksomheten

Les klarhet fra capabilities

​Individkunder

​Virksomhetskunder

​Legg til nærstående parter for virksomheten

​Les klarhet fra capabilities

Individkunder

Virksomhetskunder

Legg til nærstående parter for virksomheten

Les klarhet fra capabilities