Clients

Crea el client abans de construir un cobrament, un pagament o un compte bancari emès. Les capacitats, els comptes i les transferències s’associen a aquest client. Utilitza externalId com a mapatge estable al registre corresponent al teu sistema.

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

Clients individuals

Un individu només requereix type. Inclou els camps de perfil que ja coneixes i afegeix-ne més només quan la capacitat o la tasca actual els necessiti. Crea el client amb 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

Emmagatzema el data.id retornat com a CUSTOMER_ID. Consulta Incorporació d’individus per al context de política.

Clients de negoci

Un negoci requereix business.legalName. Crea el negoci amb la mateixa operació:

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

Emmagatzema el data.id retornat com a CUSTOMER_ID. Consulta Incorporació de negocis per al context de política i documents.

Afegeix parts relacionades del negoci

Afegeix directors, propietaris i altres participants del negoci quan siguin coneguts o sol·licitats. Aquest exemple crea un director amb 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

Emmagatzema el data.id retornat com a RELATED_PARTY_ID.

Llegeix la preparació a partir de les capacitats

Un client no té un estat de verificació o de preparació a l’API. Llegeix el client amb GET /v3/customers/{customerId} per obtenir les dades de perfil actuals, i després utilitza les capacitats i els seus openTaskIds per decidir què pot fer a continuació el client.

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

A continuació, continua a Capacitats i tasques per descobrir i activar el resultat de producte que necessites.

Comença aquí

Incorpora clients

Construeix fluxos de diners

Llança

Clients individuals

Clients de negoci

Afegeix parts relacionades del negoci

Llegeix la preparació a partir de les capacitats

​Clients individuals

​Clients de negoci

​Afegeix parts relacionades del negoci

​Llegeix la preparació a partir de les capacitats

Clients individuals

Clients de negoci

Afegeix parts relacionades del negoci

Llegeix la preparació a partir de les capacitats