Kunden

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.

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

Einzelpersonen-Kunden

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 an:

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 für den Richtlinienkontext.

Unternehmens-Kunden

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

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 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 an:

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} für aktuelle Profildaten und verwenden Sie dann Fähigkeiten und deren openTaskIds, um zu entscheiden, was der Kunde als Nächstes tun kann.

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 fort, um das benötigte Produktergebnis zu entdecken und zu aktivieren.

Erste Schritte

Kunden onboarden

Geldflüsse aufbauen

Livegang

Einzelpersonen-Kunden

Unternehmens-Kunden

Verbundene Parteien für Unternehmen hinzufügen

Bereitschaft aus Fähigkeiten lesen

​Einzelpersonen-Kunden

​Unternehmens-Kunden

​Verbundene Parteien für Unternehmen hinzufügen

​Bereitschaft aus Fähigkeiten lesen

Einzelpersonen-Kunden

Unternehmens-Kunden

Verbundene Parteien für Unternehmen hinzufügen

Bereitschaft aus Fähigkeiten lesen