Guia de Clientes

Confira o guia de clientes para mais informações.

Para que seja possível criar uma cobrança, antes é necessário criar o cliente ao qual ela irá pertencer. Você deve utilizar o ID retornado nesta requisição na criação da cobrança.

Caso você envie o postalCode do cliente, não é necessário enviar os atributos city, province e address, pois o Asaas preencherá estas informações automaticamente com base no CEP que você informou. Nestes casos basta enviar somente postalCode e addressNumber.

No campo city é retornado um identificador. Caso você queira obter o nome e demais informações da cidade você deve fazer a seguinte requisição utilizando esse identificador:
GET https://api.asaas.com/v3/cities/{city_id}

🚧
Atenção
O sistema permite a criação de clientes duplicados. Portanto, se você não quiser permitir é necessário implementar a validação antes de realizar a criação do cliente. Você pode consultar a existência do cliente no Listar Clientes.

📘
Produção: Caso seu cliente seja estrangeiro, será necessário entrar em contato com seu Gerente de Contas para que ele solicite a liberação em seu cadastro de criação de clientes estrangeiros.
Sandbox: Em sandbox é possível gerar clientes estrangeiros sem liberação prévia.

🚧
Importante
O envio e recebimento de notificações de email e SMS funcionam normalmente em Sandbox. Portanto você não deve criar clientes com emails e celulares reais ou números aleatórios como (51) 9999-9999. Para testar o recebimento de notificações você pode utilizar os seus próprios emails e celulares.