Provision accounts at customer creation
You can now pass an accounts array of currency codes when creating a customer. Each currency provisions an account that enters verification and becomes ACTIVE once approved. The customer response now also returns the linked accounts with their id and currency.
Transition period: Until June 19, 2026, the accounts field is optional. During this period, if no account is specified, the BRL account will be created. After this date, it will be required when creating a customer.
A
"type": "BUSINESS",
"legalName": "Lumx Tecnologia LTDA",
"taxId": "00.000.000/0001-91",
"incorporationDate": "2020-01-01",
"country": "BRA",
"email": "hello@lumx.io",
"accounts": [
{ "id": "8412f484-32fe-418f-80d1-99eb1b3ba7f3", "currency": "BRL" },
{ "id": "af04e979-360a-428a-84e6-cbd8ffc4942b", "currency": "USD" },
{ "id": "d06d342c-629a-4d99-a26f-34e8ea528403", "currency": "EUR" },
{ "id": "16cb802f-8521-41ad-ab6e-dc40f43c0ad3", "currency": "MXN" }
]
}
Read accounts
List a customer’s accounts via GET /accounts. Each account is linked to a customer and runs through a verification workflow (PROVISIONING→ACTIVE). See Accounts for details.
A
"data": [
{
"id": "433bbe8b-feba-49e3-80f8-7bb528d3744e",
"customerId": "3b55a2fa-57dc-48f1-ac0f-ac1d5ba4674a",
"currency": "BRL",
"status": "ACTIVE",
"createdAt": "2026-05-13T20:49:13.236Z",
"updatedAt": "2026-05-14T13:55:15.418Z"
}
]
}
Account webhook events
Subscribe to account.provisioning,account.rfi,account.active, and account.closedto receive real-time updates as an account moves through verification. See Available events.
