Pular para as operações

Bancário

Asaas em um fluxo de decisão.

7 Asaas operations a decision flow can call directly, with the credentials your own contract issued. The response is data the rest of the flow reads, branches on, and keeps in the trace.

Categoria
Bancário
Tipo
Integração
Autenticação
Chave de API
Ambiente de teste
Host de sandbox separado

Quem são

Plataforma brasileira de pagamentos e recebíveis para pequenas empresas e fintechs.

Asaas issues boletos, Pix charges and card payments, chases them when they go unpaid, and settles the money into the merchant's account. It is used mainly by Brazilian small businesses and by fintechs that need a billing stack without becoming a payment institution themselves. The same account carries the charge history, which is a record of what a customer actually paid rather than what they promised.

O que um fluxo pode chamar

7 operações, cada uma um passo que você coloca no editor.

  1. POST/customers

    Criar um cliente

    Cadastra o pagador. cpfCnpj é o campo pelo qual a Asaas deduplica, então informá-lo impede que uma segunda proposta da mesma pessoa crie um segundo cliente.

  2. GET/customers?cpfCnpj=$data.cpf

    Encontrar um cliente

    Procura um pagador pelo documento. Rode antes de criar um — a Asaas recusa uma duplicata em vez de devolver o que já existe, então um fluxo sem esse passo falha em todo solicitante que volta.

  3. POST/payments

    Gerar uma cobrança

    Cria a cobrança que a decisão aprovou. billingType aceita BOLETO, PIX, CREDIT_CARD ou UNDEFINED, sendo que UNDEFINED deixa o pagador escolher.

  4. GET/payments/$data.asaas_payment_id

    Check a charge's status

    O estado de uma cobrança. É a leitura que uma decisão de renovação faz: PENDING antes do vencimento é normal; OVERDUE depois dele é o sinal que importa.

  5. GET/payments?customer=$data.asaas_customer_id

    List a customer's charges

    Todas as cobranças emitidas contra um pagador. Esse é o histórico de pagamento que uma decisão de aumento de limite deveria ler — quantas foram pagas em atraso, e por quanto tempo, é uma evidência sobre a sua própria carteira que nenhum bureau tem.

  6. GET/finance/payment/statistics?customer=$data.asaas_customer_id&status=OVERDUE

    Ler totais das cobranças

    Totais em vez de linhas — quanto está em aberto, vencido ou recebido para um filtro.

  7. GET/finance/balance

    Ler o saldo da conta

    The Asaas account's own balance. Useful for an operational rule rather than a credit one — a disbursement flow that should stop before it overdraws the funding account.

Onde isso entra na decisão

Banking calls have a natural place in a flow.

O dado bancário responde à pergunta que a renda declarada não responde: o que de fato entra, com que regularidade, e o que sai de novo. Normalmente é puxado uma vez por proposta e depois lido por vários nós — capacidade de pagamento, verificação de renda, qualquer regra sobre volatilidade de saldo — então vale buscá-lo cedo e derivar dele, em vez de chamá-lo repetidas vezes.

Whatever Asaas returns is part of the run, so it is part of the record. When someone asks months later why an applicant was declined, the answer cites what came back at the time rather than re-fetching from a service whose answer has since changed.

  • 01Add Asaas as a connection authenticating with an API key.
  • 02A Asaas mantém um host de sandbox separado, então um fluxo no Sandbox consegue fazer a chamada real sem tocar em produção.
  • 03Coloque um nó de Conexão e escolha uma operação — “Criar um cliente” costuma ser a primeira de que um fluxo precisa.
  • 04Mapeie a resposta nos campos que suas regras leem e depois teste o caminho inteiro antes de ele receber tráfego de produção.

Perguntas frequentes

Usando a Asaas em um fluxo.

Como conecto a Asaas a um fluxo de decisão?

Adicione a Asaas como uma conexão no seu workspace, autenticando com uma chave de API, com as credenciais que o seu próprio contrato emitiu — a ArboRule chama o provedor no seu lugar e nunca assume um contrato por você. Depois que a conexão existe, qualquer fluxo do workspace pode colocar um nó de Conexão e escolher uma das operações dela. As credenciais ficam na conexão, não no fluxo, então quem cuida da política usa a Asaas em uma decisão sem nunca ver o segredo.

Dá para testar a Asaas sem tocar em produção?

Dá. A Asaas mantém um host de sandbox separado, então um fluxo rodando no Sandbox faz a chamada real com credenciais de teste e você lê o formato verdadeiro da resposta na trilha antes de qualquer coisa chegar a um cliente. O fluxo não muda quando é promovido — muda só quais credenciais respondem.

O que um fluxo pode chamar na Asaas?

7 operações, incluindo “Criar um cliente”, “Encontrar um cliente”, “Gerar uma cobrança”. Cada uma é um passo que você coloca no editor e mapeia nos campos que suas regras leem, e a maioria dos fluxos começa por “Criar um cliente”. A lista vem do mesmo manifesto que o motor usa para fazer a chamada, então esta página não consegue descrever uma operação que o produto não tem.

Em que ponto de uma decisão a Asaas deve ser chamada?

O dado bancário responde à pergunta que a renda declarada não responde: o que de fato entra, com que regularidade, e o que sai de novo. Normalmente é puxado uma vez por proposta e depois lido por vários nós — capacidade de pagamento, verificação de renda, qualquer regra sobre volatilidade de saldo — então vale buscá-lo cedo e derivar dele, em vez de chamá-lo repetidas vezes.

Also in Banking

Quando você quiser

Wire Asaas into a real decision.

Monte o fluxo no Sandbox, conecte sua conta e veja a decisão buscar o que precisa antes de responder.

Leia a documentação