Content

Product

Improving customer onboarding

Customer onboarding now includes automatic UBO role assignment, proof-of-address requirements, and terms-of-service acceptance before verification.

Abstract changelog cover for improving customer onboarding
Abstract changelog cover for improving customer onboarding

Auto-assign UBO role to sole shareholders

If an individual associated party is the only shareholder, the system will automatically add UBO to their roles array. No action required from your side.

PROOF_OF_ADDRESS document now required

A PROOF_OF_ADDRESS document is now required when uploading documents for individual customers, business customers, UBOs, and representatives. You can’t start a verification without sending this document.

The proof of address document must have been issued within the last 90 days.

A

{
"type": "PROOF_OF_ADDRESS"
}

Terms of service acceptance required before verification

Transition period: Until April 16, 2026, acceptance of terms of service will be optional to start a verification. After this date, acceptance will be mandatory.

Customers must now accept terms of service before verification can start. Send a POST request to /customers/{id}/tos with an optional redirectUrl to get the acceptance URL. Share the returned URL with your customer. The requirements array includes TERMS_OF_SERVICE until the customer has accepted. See also Read a customer.

Request body (optional)

A

{
"redirectUrl": "https://yourapp.com/onboarding/next-step"
}

Response

A

{
"url": "https://dashboard.lumx.io/tos/sandbox/eyJhbGciOiJSUzI1...",
"expiresAt": "2026-04-09T16:00:00Z"
}

The acceptance URL expires after 24 hours. Generate a new one if it expires before the customer accepts.

Stay up to date with what Lumx is developing.

Sign up to receive them by email.

Lumx

Copy link

Copied!

improving-customer-onboarding

Product

In this page

©2026. All rights reserved.

LUMX SOCIEDADE PRESTADORA DE SERVIÇOS DE ATIVOS VIRTUAIS LTDA., a private legal entity, enrolled with the CNPJ/MF under No. 42.887.120/0001-00 ("Lumx"), acts as a virtual asset service provider and is in the process of adapting to the regulatory regime for Virtual Asset Service Provider Companies (SPSAV), pursuant to Central Bank of Brazil (BCB) Resolution No. 520/2025, currently being subject to the transition regime set forth in Article 88 thereof.


Lumx US OP LLC ("Lumx") is a financial technology and payments infrastructure company. Lumx US OP LLC is a Money Service Business (MSB) registered with the Financial Crimes Enforcement Network (FinCEN) (MSB #31000316459619). Lumx is not a state-licensed money transmitter and does not, in its own capacity, engage in the provision of regulated money transmission services. All such regulated activities are conducted exclusively through, and under the licenses of, duly authorized financial-institution partners.


Lumx is not a bank, financial institution, payment institution, or custodian of client funds. Certain services made available through the Platform may be provided by duly authorized and regulated third-party partners, in accordance with applicable laws and regulations.

Please refer to Lumx’s Terms of Use and Privacy Notice for further information regarding the conditions governing the use of the Platform and the processing of your personal data.