Klienti

Izveidojiet klientu, pirms veidojat iemaksu, izmaksu vai izsniegtu bankas kontu. Iespējas, konti un pārvedumi ir ierobežoti ar šo klientu. Izmantojiet externalId kā stabilu piesaisti attiecīgajam ierakstam jūsu sistēmā.

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

Privātpersonas klienti

Privātpersonai nepieciešams tikai type. Iekļaujiet profila laukus, kurus jau zināt, un pievienojiet citus tikai tad, kad pašreizējai iespējai vai uzdevumam tie ir nepieciešami. Izveidojiet klientu ar 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

Saglabājiet atgriezto data.id kā CUSTOMER_ID. Skatiet Privātpersonu iesaiste, lai iepazītos ar politikas kontekstu.

Uzņēmumu klienti

Uzņēmumam nepieciešams business.legalName. Izveidojiet uzņēmumu ar to pašu operāciju:

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

Saglabājiet atgriezto data.id kā CUSTOMER_ID. Skatiet Uzņēmumu iesaiste, lai iepazītos ar politiku un dokumentu kontekstu.

Pievienojiet uzņēmuma saistītās puses

Pievienojiet direktorus, īpašniekus un citus uzņēmuma dalībniekus, kad tie ir zināmi vai pieprasīti. Šis piemērs izveido direktoru ar 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

Saglabājiet atgriezto data.id kā RELATED_PARTY_ID.

Nolasiet gatavību no iespējām

Klientam API nav verifikācijas vai gatavības statusa. Nolasiet klientu ar GET /v3/customers/{customerId}, lai iegūtu pašreizējos profila datus, pēc tam izmantojiet iespējas un to openTaskIds, lai izlemtu, ko klients var darīt tālāk.

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

Tālāk turpiniet uz Iespējas un uzdevumi, lai atklātu un aktivizētu nepieciešamo produkta rezultātu.

Sākt darbu

Klientu iekļaušana

Veidot naudas plūsmas

Palaišana

Privātpersonas klienti

Uzņēmumu klienti

Pievienojiet uzņēmuma saistītās puses

Nolasiet gatavību no iespējām

​Privātpersonas klienti

​Uzņēmumu klienti

​Pievienojiet uzņēmuma saistītās puses

​Nolasiet gatavību no iespējām

Privātpersonas klienti

Uzņēmumu klienti

Pievienojiet uzņēmuma saistītās puses

Nolasiet gatavību no iespējām