고객 - Swipelux

페이인, 페이아웃 또는 발급 은행 계좌를 구축하기 전에 고객을 생성하세요. 케이퍼빌리티, 계좌, 전송은 그 고객으로 범위가 지정돼요. externalId를 시스템 내 해당 레코드로의 안정적인 매핑으로 사용하세요.

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

개인 고객

개인은 type만 필요해요. 이미 알고 있는 프로필 필드를 포함하고, 현재 케이퍼빌리티나 태스크가 필요로 할 때만 추가하세요. 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

반환된 data.id를 CUSTOMER_ID로 저장하세요. 정책 컨텍스트는 개인 온보딩을 참고하세요.

기업 고객

기업은 business.legalName이 필요해요. 동일한 동작으로 기업을 생성하세요:

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

반환된 data.id를 CUSTOMER_ID로 저장하세요. 정책과 문서 컨텍스트는 기업 온보딩을 참고하세요.

기업 관계자 추가

이사, 소유자, 기타 기업 참여자가 알려지거나 요청되면 추가하세요. 이 예시는 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

반환된 data.id를 RELATED_PARTY_ID로 저장하세요.

케이퍼빌리티에서 준비 상태 확인

고객은 API 내에서 검증이나 준비 상태를 별도로 갖지 않아요. 현재 프로필 데이터를 위해 GET /v3/customers/{customerId}로 고객을 조회한 뒤, 케이퍼빌리티와 그 openTaskIds를 사용해 고객이 다음에 무엇을 할 수 있는지 결정하세요.

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

다음으로, 케이퍼빌리티와 태스크로 넘어가 필요한 제품 결과를 발견하고 활성화하세요.

시작하기

고객 온보딩

자금 흐름 구축

출시

고객

개인 고객

기업 고객

기업 관계자 추가

케이퍼빌리티에서 준비 상태 확인

​개인 고객

​기업 고객

​기업 관계자 추가

​케이퍼빌리티에서 준비 상태 확인

개인 고객

기업 고객

기업 관계자 추가

케이퍼빌리티에서 준비 상태 확인