Ir para conteúdo
Integrações / Gateways / Asaas

Integração com o
Asaas
para recorrência
e SaaS

Desenvolvimento de integração com a API do Asaas para cobrança recorrente, régua de inadimplência, Pix, boleto e sistemas que precisam automatizar o ciclo financeiro com clientes.

RecorrênciaRégua de CobrançaPixBoletoCartãoWebhooksSandbox
Sobre o Asaas

O gateway e sua API

O Asaas é uma fintech brasileira com gateway de pagamento e funcionalidades de gestão financeira integradas. Sua API REST suporta criação de cobranças via Pix, boleto e cartão, gestão de clientes, assinaturas recorrentes e régua automática de notificações para inadimplência.

O diferencial do Asaas em relação às outras adquirentes está no foco em recorrência e gestão do ciclo financeiro. Enquanto gateways como Cielo e Rede são fortes no processamento de transações avulsas, o Asaas foi projetado para negócios que cobram clientes de forma contínua — SaaS, prestadores de serviço, escolas, academias e qualquer modelo com mensalidade ou assinatura.

Um ponto técnico relevante: a régua de cobrança do Asaas é configurável via API, mas funciona de forma assíncrona. As notificações disparam em momentos específicos do ciclo de vida da cobrança e chegam como eventos via webhook. A integração precisa mapear esses eventos corretamente para manter o sistema sempre sincronizado com o status real de cada cliente.

O que a integração cobre

Aspectos técnicos
do desenvolvimento

Cobrança recorrente nativa

A API do Asaas suporta criação de assinaturas com ciclos configuráveis — semanal, mensal, anual. Cada ciclo gera cobranças automaticamente nos métodos escolhidos pelo cliente, sem intervenção manual.

Régua de inadimplência

O Asaas permite configurar sequências automáticas de notificações por e-mail e SMS antes e depois do vencimento. A régua pode ser acionada via API e o status de cada etapa retorna via webhook.

Pix, boleto e cartão

A integração cobre os três métodos principais do Asaas — Pix com QR Code dinâmico, boleto com vencimento configurável e cartão de crédito com tokenização. O cliente escolhe o método na criação da assinatura.

Gestão de clientes via API

O Asaas tem um módulo de clientes que pode ser gerenciado inteiramente via API. É possível criar, atualizar e consultar clientes diretamente do sistema, sem precisar do painel manual.

Webhooks de status

O Asaas notifica o sistema via webhook sempre que o status de uma cobrança muda — confirmado, vencido, cancelado, estornado. A integração inclui o endpoint receptor com validação e processamento idempotente.

Sandbox e testes

Ambiente de sandbox separado com chave de API própria para testar cobranças, assinaturas, régua e webhooks antes de publicar em produção — sem risco de transações reais.

Integração via API

Por que não usar
o painel manual

Quando o painel é suficiente

Para volumes baixos de cobranças e fluxo simples, o painel do Asaas já resolve. Se você emite menos de algumas dezenas de cobranças por mês sem automação entre sistemas, a interface web pode ser suficiente.

Quando a integração via API é necessária

  • Seu sistema precisa criar cobranças automaticamente sem acesso manual ao painel
  • Você tem SaaS com criação de assinatura no momento do cadastro do cliente
  • O status de pagamento precisa atualizar o sistema em tempo real via webhook
  • Você tem ERP e quer eliminar a emissão manual de boletos e Pix
  • Precisa de régua de inadimplência configurada programaticamente por tipo de cliente
  • Quer relatórios financeiros puxados da API e consolidados no seu sistema
  • O volume de clientes torna o uso manual do painel inviável

A API do Asaas foi projetada para ser o backend financeiro de sistemas externos. A integração transforma o Asaas em um módulo de cobrança do seu sistema, invisível para o usuário final.

Conversar sobre o projeto
Cenários de uso

Quando a integração
com o Asaas faz sentido

Cobrança recorrente

SaaS com planos e assinaturas

Você tem um produto SaaS com planos mensais ou anuais e precisa cobrar clientes automaticamente a cada ciclo. A integração com a API do Asaas cria e gerencia as assinaturas diretamente no sistema, com notificação de falha e retentativa automática para cartão.

Gestão de cobranças

Prestadores de serviço com alto volume de clientes

Escolas, academias, clínicas e prestadores com dezenas ou centenas de cobranças mensais. A integração automatiza a emissão de cobranças, ativa a régua de inadimplência e atualiza o status no sistema sem trabalho manual.

Backend customizado

Sistema próprio com emissão de boleto e Pix

Seu sistema precisa emitir cobranças programaticamente — boleto com vencimento configurado, Pix com QR Code, link de pagamento. A integração via API do Asaas faz isso sem o uso manual do painel.

Integração com ERP

ERP com cobrança automatizada

Seu ERP gera os títulos a cobrar, mas a emissão e acompanhamento ainda são manuais. A integração conecta o ERP ao Asaas para emitir cobranças automaticamente e receber o status de volta — pago, vencido, cancelado.

Processo

Como o projeto funciona

Análise do ambiente

Entender a plataforma, o backend e se há necessidade de assinatura recorrente, régua, múltiplos métodos de pagamento ou integração com outros sistemas.

Levantamento de requisitos

Quais métodos de pagamento, se há recorrência, ciclos, régua de inadimplência, webhook e quais eventos precisam atualizar o sistema.

Configuração do sandbox

Chave de API do sandbox do Asaas e leitura da documentação para mapear os endpoints, modelos de dado e comportamento esperado da API.

Desenvolvimento

Construção dos endpoints de criação de clientes, cobranças, assinaturas, régua e webhook com tratamento de erros e log estruturado.

Testes de homologação

Simulação de todos os cenários no sandbox: cobrança avulsa, ciclo de assinatura, falha de cobrança, retentativa, régua ativada e webhook.

Publicação em produção

Migração para a chave de produção do Asaas, deploy e acompanhamento das primeiras cobranças reais para garantir que o fluxo está correto.

Plataformas e ambientes

SaaS próprio

Assinatura criada no cadastro, cobrança automática a cada ciclo

ERP

Emissão programática de boletos e Pix integrada ao fluxo de pedidos

Sistema de gestão

Cobranças emitidas automaticamente com status sincronizado via webhook

Escola ou academia

Mensalidades recorrentes com régua de inadimplência automatizada

Clínica ou consultório

Cobranças avulsas e recorrentes com notificações configuradas por cliente

Prestador de serviços

Contratos com cobrança mensal e acompanhamento de inadimplência sem trabalho manual

Não viu seu tipo de negócio? Fale sobre o projeto — o processo começa pelo entendimento do fluxo atual de cobranças.

Perguntas frequentes

O que é o Asaas e como funciona sua API?

O Asaas é uma fintech com gateway de pagamento e gestão financeira integrada. Sua API REST permite criar cobranças via Pix, boleto e cartão, gerenciar assinaturas recorrentes e configurar régua de cobrança automática para inadimplentes.

O Asaas tem ambiente sandbox para testes?

Sim. O Asaas disponibiliza ambiente sandbox com chave de API separada para testar cobranças, assinaturas, régua e webhooks antes de qualquer transação real.

O Asaas é adequado para SaaS com cobrança recorrente?

Sim. O Asaas é uma das opções mais completas para recorrência no Brasil, com suporte a assinaturas, ciclos configuráveis, retentativas automáticas para cartão e régua de inadimplência.

Como funciona a régua de cobrança?

O Asaas permite configurar notificações automáticas por e-mail e SMS antes e depois do vencimento. A régua é ativável via API e os eventos chegam via webhook para atualizar o sistema.

A integração suporta Pix?

Sim. A API do Asaas suporta Pix com QR Code dinâmico e confirmação via webhook, tanto para cobranças avulsas quanto dentro de ciclos de assinatura.

É possível integrar o Asaas com um sistema próprio ou ERP?

Sim. A API é projetada para integração com sistemas externos — criar clientes, emitir cobranças, gerenciar assinaturas e receber status diretamente no sistema, sem uso manual do painel.

Como funcionam os webhooks?

O Asaas envia notificações quando o status de uma cobrança muda — confirmado, vencido, cancelado, estornado. A integração inclui o endpoint receptor com validação e atualização automática do sistema.

Quanto custa e quanto tempo leva?

Depende do escopo: recorrência, régua, múltiplos métodos, webhook e integração com outros sistemas. O melhor caminho é conversar sobre o projeto para um levantamento preciso.

Próximo passo

Precisa integrar o Asaas
ao seu sistema?

O primeiro passo é entender o fluxo atual de cobranças — quantos clientes, quais métodos, se há recorrência e o que precisa ser automatizado. Sem compromisso.

Solicitar orçamento Atendimento para todo o Brasil · Projetos remotos