Customer Onboarding
Shareholders And Documents
Understand UBOs, control persons, signers, and document collection for business customers.
Shareholders and documents help Swipelux understand who owns, controls, and can act for a business customer. Requirements can vary by jurisdiction, entity type, ownership structure, and compliance review.
Business Review Inputs
Common Roles
| Role | Meaning |
|---|---|
| UBO | A person who ultimately owns a meaningful share of the business. |
| Control person | A person with control over decisions, even without majority ownership. |
| Signer | A person authorized to act for the business. |
Documents
Business documents support the company profile. Shareholder documents support the individuals behind the company. Use the metadata endpoint and compliance feedback to collect the right document set. Upload documents through POST /v1/documents: send customerId for business-owned documents or shareholderId for shareholder evidence.
Endpoint Sequence
Related Endpoints
| Operation | Use it for |
|---|---|
POST /v1/customers/business/{businessCustomerId}/shareholders | Create a shareholder. |
GET /v1/customers/business/{businessCustomerId}/shareholders | List shareholders. |
PUT /v1/customers/business/{businessCustomerId}/shareholders/{shareholderId} | Update a shareholder. |
POST /v1/documents | Upload a business or shareholder document. |
GET /v1/documents | List document state for a customer or shareholder. |
GET /v1/meta/kyb/documents | Retrieve KYB document requirements. |