Criar subconta

Recipes
🦉
Criar uma subconta e armazenar a API Key com segurança
Open Recipe

Cria uma nova subconta vinculada à conta-pai autenticada.

A conta-pai que realiza a criação deve ser pessoa jurídica (CNPJ).

A resposta inclui a apiKey e o walletId da nova subconta. Capture a apiKey na resposta da criação, pois seu valor não poderá ser recuperado posteriormente.

Quando webhooks for informado, as configurações de Webhook são criadas junto com a subconta.

⚠️

CEP da subconta

Informe um CEP válido em postalCode. O Asaas utiliza esse valor para identificar a cidade do endereço e retorna 400 quando o CEP não pode ser localizado.

📘

Encerramento sem custo

Subcontas não-BaaS encerradas em até 48 horas após a criação não geram cobrança da taxa de criação, quando aplicável. Para isso, a subconta deve atender aos critérios de encerramento de subcontas não-BaaS, incluindo nunca ter realizado login. Após esse prazo, o encerramento por esse fluxo não é mais permitido.

Consulte os valores aplicáveis ao seu contrato em Configurações de Conta > Taxas.

Conteúdos relacionados

Guides

Body Params
string
required

Nome da subconta

string
required

Email da subconta

string

Email para login da subconta, caso não informado será utilizado o email da subconta

string
required

CPF ou CNPJ do proprietário da subconta

date

Data de nascimento (somente quando Pessoa Física)

string
enum

Tipo da empresa (somente quando Pessoa Jurídica)

Allowed:
string

Telefone Fixo

string
required

Telefone Celular

string

URL of the subbacount website

number
required

Faturamento/Renda mensal

string
required

Logradouro

string
required

Número do endereço

string

Complemento do endereço

string
required

Bairro

string
required

CEP do endereço

webhooks
array of objects

Array com as configurações de Webhooks desejadas

webhooks
string
enum

Regime tributário (somente quando Pessoa Jurídica)

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json