Pular para o conteúdo
Entregas Expressas Central de Ajuda

Integração com o Asaas: Pix, boleto, cartão e repasse aos entregadores

Como gerar a chave de API, liberar os IPs da plataforma, cadastrar o webhook e configurar Pix, boleto, cartão e o pagamento dos saques pela sua conta Asaas.

Atualizado em 17/11/2026 10 min de leitura

O que é

Com a integração com o Asaas, a sua conta Asaas passa a receber os pagamentos online dos seus clientes e a pagar os saques dos entregadores:

  • Pix, boleto e cartão de crédito para pedidos, recargas de carteira e faturas. O pagamento é confirmado sozinho, sem conferência manual.
  • Repasse aos entregadores: o saque aprovado sai por Pix da sua conta Asaas para a chave Pix do entregador.

Você pode usar o Asaas só para uma forma de pagamento, para todas ou só para o repasse.

Antes de começar

  • Conta no Asaas aprovada (com os documentos da empresa enviados e aceitos).
  • Para o repasse: saldo na conta Asaas. Os Pix dos saques saem desse saldo, e o Asaas pode cobrar tarifa por Pix enviado.
  • No Entregas Expressas, um usuário com acesso a Configurações › Pagamento Online e Configurações › Repasses Automáticos.

1. Gere a chave de API no Asaas

  1. No Asaas, abra o menu do usuário (canto superior direito) e clique em Integrações.
  2. Na aba Chaves de API, clique para gerar uma nova chave e dê um nome a ela (por exemplo, "Entregas Expressas").
  3. Se for usar o repasse aos entregadores, marque Permitir que esta chave execute operações de saque via API. Essa opção só aparece na criação da chave: sem ela, o Asaas recusa os Pix dos saques e será preciso gerar outra chave.
  4. Copie a chave e guarde-a num lugar seguro. O Asaas mostra a chave completa uma única vez.
Menu do usuário do Asaas com a opção Integrações
No menu do usuário do Asaas, clique em Integrações.
Janela Gerar chave de API do Asaas com a opção de saque destacada
Para o repasse, marque a opção de operações de saque via API antes de avançar.

Pode ser a mesma chave para o Pix, o boleto, o cartão e o repasse. Se preferir separar, gere uma chave para cada uso.

2. Libere o endereço IP da plataforma no Asaas

O Asaas permite que só endereços autorizados usem a sua chave de API, e só paga sozinho o saque que vem de um endereço da lista. Sem o endereço da plataforma liberado, o Asaas recusa as cobranças e os saques dos entregadores ficam para pagamento manual no painel. Libere este endereço:

Endereço IP
5.161.235.253

O caminho no Asaas é Minha conta › Integração › Segurança › Endereços IP autorizados na API:

  1. No Asaas, abra Minha conta (no menu do usuário, no canto superior direito) e clique na aba Integração.
    Tela Minha conta do Asaas com a aba Integração indicada
    Em Minha conta, a aba Integração fica no fim da fileira de abas.
  2. Na tela de Integrações, abra a aba Segurança.
    Abas da tela de Integrações do Asaas com Segurança indicada
    A aba Segurança fica ao lado de Chaves de API.
  3. Role até Endereços IP autorizados na API e clique em Editar (se a lista estiver vazia, o botão é Adicionar IP).
  4. Em Tipo, deixe Único e, em Endereço de IP, informe o endereço da tabela.
    Janela Editar IPs autorizados na API com um endereço preenchido
    Informe o endereço da plataforma em Endereço de IP.
  5. Clique em Avançar, confirme com o código que o Asaas enviar e salve.
  6. Confira a lista: o endereço precisa aparecer com o tipo Único.
Lista Endereços IP autorizados na API do Asaas com o endereço da plataforma
Assim fica a lista depois de salvar: 5.161.235.253.

Se a sua conta já tinha outros endereços na lista (de outro sistema que você usa), mantenha-os e só acrescente o da plataforma. Com a lista preenchida, o Asaas recusa qualquer endereço que não esteja nela.

O mesmo endereço aparece no painel, com o botão Copiar, nas telas de Pagamento Online e de Repasses Automáticos quando o Asaas está selecionado.

Enquanto o endereço não estiver liberado, uma faixa vermelha no topo do painel mostra este mesmo passo a passo. Depois de salvar no Asaas, clique em Já liberei para conferir na hora, ou espere: a plataforma confere sozinha a cada hora, e as cobranças e os repasses voltam a funcionar.

Desligue a aprovação manual dos saques

Mesmo com o endereço liberado, o Asaas pode continuar pedindo que cada saque seja aprovado na conta. Para o Pix do entregador sair sozinho:

  1. Na mesma aba Segurança, logo abaixo da lista de endereços, encontre Evento crítico em requisições de saque.
  2. Desligue a opção Gerar evento crítico em requisições de saque de endereços IP autorizados e confirme com o código que o Asaas enviar.

Com a opção ligada, todo saque fica parado até alguém aprová-lo na conta Asaas (por código no app ou SMS), e só então é pago. Deixe ligada apenas se você quer conferir e aprovar cada saque no Asaas antes de o dinheiro sair.

Não preencha a autorização de saque por webhook do Asaas (menu do usuário › Integrações › Mecanismos de segurança). A plataforma não usa esse recurso: com ele ativo, o Asaas recusa os saques dos entregadores com o motivo "Autorização externa foi recusada" e o valor volta para a carteira. Se ele estiver preenchido, desative. O aviso das transferências que a plataforma precisa é cadastrado sozinho ao salvar a tela de Repasses Automáticos.

3. Ative o Pix, o boleto e o cartão pelo Asaas

  1. No painel, vá em Configurações › Pagamento Online.
  2. Para o Pix: marque Ativar PIX e, em Gateway de Pagamento Pix, escolha Asaas.
  3. Cole a chave em Chave da API Asaas.
  4. Faça o mesmo no bloco do boleto (Ativar Boleto e Gateway de Pagamento Boleto) e no do cartão (Ativar Cartão de Crédito e Gateway de Pagamento Cartão de Crédito), conforme as formas que você quer oferecer.
  5. Clique em Salvar.
Bloco do Pix com o Asaas escolhido, a chave da API, o IP da plataforma e o botão para conferir o webhook
Com o Asaas escolhido, a tela mostra a chave da API, o IP a liberar e o botão para conferir o webhook.

O webhook de cobranças é cadastrado sozinho

É o webhook que avisa a plataforma que o cliente pagou. Ao salvar a chave, a plataforma cadastra ele na sua conta Asaas: você não precisa criar nada na aba Webhooks.

Se o webhook for apagado no Asaas ou pausado por falhas seguidas, os pagamentos deixam de ser confirmados no painel. Na tela de Pagamento Online, clique em Conferir webhook no Asaas: a plataforma cadastra ou reativa o webhook.

4. Pague os saques dos entregadores pelo Asaas

  1. No painel, vá em Configurações › Repasses Automáticos.
  2. Marque Habilitar Repasses Automáticos.
  3. Em Conta utilizada para os repasses, escolha Asaas.
  4. Cole a chave em Chave da API Asaas. Ela precisa ter sido gerada com a opção de operações de saque (passo 1).
  5. Confira se o endereço IP da plataforma está liberado. O botão Como liberar o IP no Asaas mostra o passo a passo com o endereço para copiar.
  6. Para o saque sair sem aprovação manual, confira também se a opção Gerar evento crítico em requisições de saque de endereços IP autorizados está desligada e se a autorização de saque por webhook está vazia (veja Desligue a aprovação manual dos saques).
  7. Clique em Salvar. Ao salvar, a plataforma conecta a sua conta Asaas e cadastra sozinha o aviso de transferências: você não precisa criar outro webhook.
Tela de Repasses Automáticos com o Asaas como conta dos repasses
Com o Asaas escolhido, cole a chave e use o botão Como liberar o IP no Asaas.

Depois disso, configure quando os saques são pagos: pagamento programado, horários com pagamento automático ou saque imediato.

Como o saque anda

  1. O saque é aprovado (na hora programada, num horário de pagamento automático ou em Financeiro › Saques e repasses, selecionando os saques pendentes e clicando em Realizar Pagamento).
  2. O Pix é criado na sua conta Asaas e o saque fica aguardando confirmação.
  3. Quando o Asaas conclui o Pix, o saque é marcado como pago sozinho.
  4. Se o Asaas recusar ou cancelar a transferência, o saque é recusado e o valor volta para a carteira do entregador.

No Portal B2B

Com o Asaas ligado, o seu cliente paga pelo Portal B2B (e pelo App B2B) nestes pontos:

  • Pedido: ao lançar, ele toca na linha Pagamento e escolhe Pix ou Cartão de Crédito no grupo Pagar agora. Depois de enviar, a página do pedido mostra o QR Code e o código copia e cola do Pix, ou os cartões salvos com a opção Adicionar novo cartão. O boleto não é oferecido para pagar pedido.
  • Carteira: em Carteira › Adicionar Saldo, ele escolhe a forma em Selecione o método de pagamento.
  • Fatura: em Faturas › Detalhes de uma fatura em aberto, ele paga pelas formas liberadas em Formas de Pagamento para Faturas.

Quando o pagamento é confirmado, o pedido, a recarga ou a fatura é baixado sozinho. Passo a passo do lado do cliente em Pagar pedido no Portal B2B, Carteira no Portal B2B e Faturas no Portal B2B. Se aparecer um aviso na hora de pagar, veja Mensagens de erro do Portal B2B: pagamento.

No app do entregador

Quem pode usar

Em Perfis de Acesso, as permissões são Configurações de pagamentos online (Pix, boleto e cartão) e Configurações repasse automático (saques). O administrador já vem com as duas.

Perguntas frequentes

O saque fica parado em "aguardando confirmação". O que fazer?

O Asaas está pedindo aprovação manual de cada Pix. Confira em Integrações › Segurança no Asaas:

  • se o endereço da plataforma está na lista de Endereços IP autorizados na API;
  • se a opção Gerar evento crítico em requisições de saque de endereços IP autorizados está desligada. Ligada, ela pede aprovação de todo saque, mesmo com o endereço liberado.

Os saques que já estão parados podem ser aprovados na própria conta Asaas.

O saque foi recusado com "Autorização externa foi recusada". Por quê?

A autorização de saque por webhook está ativa na sua conta Asaas (Integrações › Mecanismos de segurança). A plataforma não responde a ela, então o Asaas cancela o Pix. Desative esse recurso no Asaas; o entregador pode pedir o saque de novo em seguida.

Desliguei a aprovação manual e os saques passaram a ser recusados.

Confira dois pontos: se a autorização de saque por webhook está vazia (veja a pergunta acima) e se o endereço da plataforma continua na lista. Saque vindo de um endereço fora da lista é recusado pelo Asaas.

Apareceu "Não foi possível conectar a esta conta Asaas". E agora?

A chave foi recusada pelo Asaas. Confira se você colou a chave inteira, se ela é de produção (chave do ambiente de testes não funciona) e se não foi desativada no Asaas. Cole de novo e salve.

O cliente pagou, mas o pedido continua como não pago.

Na tela de Pagamento Online, clique em Conferir webhook no Asaas. Se aparecer erro de endereço IP, confira se o IP da plataforma continua na lista de endereços autorizados do Asaas.

Esqueci de marcar a opção de saque na chave. Dá para editar?

Não. A opção só existe na criação. Gere uma chave nova com ela marcada, cole em Repasses Automáticos e salve.

Muda algo para o meu cliente?

Ele passa a ver as formas que você ativou na hora de pagar o pedido, a recarga ou a fatura. Para tirar uma forma de um contexto, veja Bloquear formas de pagamento online.

Ficou alguma dúvida?Pergunte ao IAGo sobre este artigo.
Este artigo ajudou?