Cobranças

Dúvidas frequentes sobre cobranças na API do Asaas

Erro 400 invalid_billingType tentando criar uma cobrança utilizando o billingType CREDIT_CARD?

Você precisa ir em MINHA CONTA > INFORMAÇÕES > DADOS COMERCIAIS e preencher todos os dados, incluindo cpfCnpj ou então realizar a chamada de atualizar dados comerciais enviando todos os dados. Após isso, é só tentar novamente.

Somente contas com 100% dos dados comerciais preenchidos e aprovados poderão criar cobranças de cartão de crédito.

Meu sistema não está atualizando as cobranças do Asaas, o que pode ser?

Você precisa visualizar como o seu sistema realiza a baixa das cobranças. Isso pode ser feito através dos webhooks. Caso você utilize webhooks e suas cobranças não estejam atualizando no seu sistema, provavelmente você está com um problema de fila interrompida do seu Webhook. Isso acontece quando há alguma falha de comunicação da sua aplicação com o Asaas.

Confira a documentação de fila pausada para mais detalhes

Nela falamos sobre os principais erros de webhook.

Como criar uma cobrança pré-autorizada?

Cobranças com pré-autorização permitem que você valide o limite disponível no cartão do seu cliente, sem necessariamente capturar a transação.

Essa modalidade geralmente é usada em locadoras de veículos, onde um caução é reservado para garantia de crédito.

No Asaas, você pode realizar pré-autorizações usando a API de criação de cobrança. A única diferença, é que para pré-autorizar, você deverá enviar o parâmetro authorizedOnly com valor true. Dessa forma, se ocorrer a validação, a transação será criada com o status AUTHORIZED.

Caso queira capturar a transação, poderá fazer consumindo esta API.

O prazo máximo possível para a pré-autorização no momento é de 3 dias, portanto, caso após o período a transação ainda não tenha sido capturada, ela será automaticamente estornada.

Caso precise estornar a transação antes dos 3 dias, basta utilizar a API de estorno disponível.

O que fazer quando estiver recebendo muitas recusas de cartão?

Primeiro é importante ressaltar que recusa de cartão não é uma demanda de API, visto que, quem recusa a transação de cartão são as adquirentes, emissores de cartão ou o validador de segurança, não a Integração API. Logo, é uma demanda que precisa ser verificar com o gerente de contas. Caso estejam ocorrendo muitas recusas de cartão, o indicado é conversar com seu gerente de contas para entender o que está ocorrendo.