Como o Asaas trata receitas na conta?

No Asaas a principal fonte de receitas são as cobranças.

Sempre que um valor entra na conta, o Asaas registra a receita no extrato e a associa a uma cobrança.

Dependendo da origem do recebimento, essa cobrança pode ser criada automaticamente e conter campos que identificam o recurso relacionado.

📘

Acompanhe o Webhook de Cobranças e utilize os campos retornados para identificar a origem de cada cobrança.

Como identificar a origem da cobrança

OrigemComportamentoCampo de identificação
AssinaturaUma nova cobrança é criada a cada ciclosubscription
Link de pagamentoUma cobrança é criada quando o link é utilizadopaymentLink
QR Code Pix estáticoUma cobrança Pix é criada após o recebimentopixQrCodeId
Transferência Pix recebidaUma cobrança é criada automaticamentepixTransaction
TED recebidaUma cobrança é criada automaticamenteDescrição da cobrança

Assinaturas

As assinaturas geram novas cobranças conforme a periodicidade configurada.

Em cobranças por cartão de crédito, o pagamento pode ocorrer automaticamente. Em outros meios, como boleto, a cobrança é criada para pagamento pelo cliente.

As cobranças originadas por uma assinatura apresentam o campo subscription com o ID correspondente.

Links de pagamento

Quando um cliente utiliza um link de pagamento, uma cobrança é criada.

Em pagamentos por cartão de crédito ou Pix, a cobrança pode ser criada já como paga. No boleto, ela permanece disponível para pagamento conforme as configurações do link.

O campo paymentLink apresenta o ID do link que originou a cobrança.

QR Code Pix estático

Ao receber um pagamento por um QR Code Pix estático, o Asaas cria uma cobrança com:

  • billingType igual a PIX;
  • pixQrCodeId com o ID do QR Code utilizado.

No extrato, a cobrança será apresentada com a descrição:

Cobrança criada automaticamente a partir de Pix recebido.

Transferências recebidas

Transferências recebidas por Pix ou TED também criam cobranças automaticamente.

Pix

A cobrança apresenta o campo pixTransaction com o ID da transação Pix.

TED

A cobrança será apresentada com a descrição:

Cobrança gerada automaticamente a partir de TED recebido.

Recomendação para sua integração

Para identificar a origem de uma receita, verifique os campos da cobrança recebida pelo Webhook.

Evite utilizar apenas a descrição exibida no extrato, pois os campos relacionados ao recurso oferecem uma identificação mais estruturada.


Did this page help you?