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.
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
- No Asaas, abra o menu do usuário (canto superior direito) e clique em Integrações.
- Na aba Chaves de API, clique para gerar uma nova chave e dê um nome a ela (por exemplo, "Entregas Expressas").
- 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.
- Copie a chave e guarde-a num lugar seguro. O Asaas mostra a chave completa uma única vez.
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:
- No Asaas, abra Minha conta (no menu do usuário, no canto superior direito) e clique na aba Integração.
Em Minha conta, a aba Integração fica no fim da fileira de abas. - Na tela de Integrações, abra a aba Segurança.
A aba Segurança fica ao lado de Chaves de API. - Role até Endereços IP autorizados na API e clique em Editar (se a lista estiver vazia, o botão é Adicionar IP).
- Em Tipo, deixe Único e, em Endereço de IP, informe o endereço da tabela.
Informe o endereço da plataforma em Endereço de IP. - Clique em Avançar, confirme com o código que o Asaas enviar e salve.
- Confira a lista: o endereço precisa aparecer com o tipo Único.
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:
- Na mesma aba Segurança, logo abaixo da lista de endereços, encontre Evento crítico em requisições de saque.
- 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
- No painel, vá em Configurações › Pagamento Online.
- Para o Pix: marque Ativar PIX e, em Gateway de Pagamento Pix, escolha Asaas.
- Cole a chave em Chave da API Asaas.
- 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.
- Clique em Salvar.
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
- No painel, vá em Configurações › Repasses Automáticos.
- Marque Habilitar Repasses Automáticos.
- Em Conta utilizada para os repasses, escolha Asaas.
- Cole a chave em Chave da API Asaas. Ela precisa ter sido gerada com a opção de operações de saque (passo 1).
- 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.
- 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).
- 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.
Depois disso, configure quando os saques são pagos: pagamento programado, horários com pagamento automático ou saque imediato.
Como o saque anda
- 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).
- O Pix é criado na sua conta Asaas e o saque fica aguardando confirmação.
- Quando o Asaas conclui o Pix, o saque é marcado como pago sozinho.
- 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
- Pedido pago online: a forma de pagamento aparece com o nome do gateway, e o entregador não cobra nada na entrega. Para esconder essa informação, ligue Ocultar forma de pagamento em pagamentos online.
- Saque: o entregador pede em Carteira › Solicitar Saque e informa a chave Pix (se a chave for definida pela empresa, o campo vem travado com "Chave PIX definida pela empresa. Para trocar, fale com a central."). Ele acompanha cada saque, as taxas e quanto caiu na conta em Extrato de saques. Veja Como o entregador solicita um saque pelo app e Extrato de saques no app.
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.