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