💠 Pix integrado: Asaas e MaisEntregas

Tempo estimado de leitura: 5 minutos

A integração entre a MaisEntregas e o Asaas permite que seus Clientes Solicitantes utilizem o Pix para realizar operações financeiras na plataforma, como:

• Comprar créditos;
• Gerar corridas (OS) pelo ambiente responsivo pagando via Pix.

Para disponibilizar essas funcionalidades, é necessário possuir uma conta própria no Asaas integrada à MaisEntregas e realizar algumas configurações.

📋 Requisitos para utilizar o Pix

Antes de iniciar, confirme se a transportadora possui:

1. Conta própria no Asaas integrada à MaisEntregas;
2. Chave Pix cadastrada na conta Asaas;
3. Webhook configurado para permitir a comunicação entre o Asaas e a MaisEntregas.

⚠️ Importante: Os dados cadastrados nos Clientes Solicitantes devem estar corretos e atualizados para que eles possam utilizar as funcionalidades financeiras.

🏦 1. Conta própria no Asaas

Para utilizar essa integração, a transportadora precisa possuir uma conta própria no Asaas integrada à plataforma MaisEntregas.

Caso ainda não possua uma conta integrada, será necessário realizar primeiro a criação e configuração da conta.

Acessar o Asaas

🔑 2. Cadastre uma chave Pix

Acesse sua conta no Asaas e vá até a opção:

Pix

Cadastre uma chave Pix na conta que está integrada à MaisEntregas.

Caso tenha dificuldades nessa etapa, solicite auxílio diretamente ao suporte do Asaas.

🔗 3. Configure o Webhook de cobranças

Com a conta integrada e a chave Pix cadastrada, será necessário configurar a comunicação entre os sistemas.

O Webhook é responsável por enviar informações do Asaas para a MaisEntregas, permitindo que eventos relacionados às cobranças sejam comunicados à plataforma.

3.1. Acesse as integrações

Na sua conta Asaas, acesse:

Integrações → Webhooks

Localize Webhook para cobranças e clique em Editar.

3.2. Configure o Webhook

Preencha os campos conforme abaixo:

Exemplo de URL

Se a URL da sua plataforma for:

salvadorexpress.maisentregas.com

O Webhook deverá utilizar:

https://salvadorexpress.maisentregas.com/asaas/webhook

⚠️ Importante: Substitua [SUA_TRANSPORTADORA] pelo nome utilizado na URL da sua própria plataforma MaisEntregas.

Após preencher os campos, selecione as notificações necessárias e clique em Salvar.

⚠️ Webhook com status “Interrompido”

Caso o Webhook apresente constantemente o status Interrompido ou ocorram problemas na aprovação de pagamentos Pix:

1. Acesse novamente as configurações do Webhook;
2. Em Tipo de envio, altere para Não-Sequencial;
3. Clique em Salvar;
4. Aguarde aproximadamente 1 minuto;
5. Retorne às configurações;
6. Altere novamente para Sequencial;
7. Clique em Salvar.

Esse procedimento pode corrigir problemas relacionados à fila de sincronização dos pagamentos.

🔐 Configuração do mecanismo de segurança para saques

Além do Webhook utilizado nas cobranças, existe uma configuração relacionada à validação de segurança dos saques.

🚨 Atenção — procedimento interno: Quando a transportadora ativar o mecanismo de segurança, o Suporte MaisEntregas deve comunicar a equipe de Desenvolvimento. Conforme o processo atual descrito para essa integração, também é necessária uma ativação no banco de dados da MaisEntregas. Sem essa etapa, a integração não funcionará corretamente.

URL do Webhook

Utilize o endereço correspondente à plataforma da transportadora:

https://[SUA_TRANSPORTADORA].maisentregas.com/asaas/webhook

Exemplo:

https://teste.maisentregas.com/asaas/webhook

📌 O trecho teste é apenas um exemplo. Ele deve ser substituído pelo identificador da transportadora na URL da plataforma.

E-mail para notificação de erros

Configure um endereço de e-mail válido e monitorado para receber notificações relacionadas a erros.

Após preencher as configurações, clique em Salvar para habilitar o mecanismo.

✅ Após finalizar a configuração

Com a configuração concluída, confirme se:

• A conta própria do Asaas está integrada;
• Existe uma chave Pix cadastrada;
• O Webhook está ativo;
• A URL do Webhook corresponde à URL da transportadora;
• O token de autenticação foi configurado;
• A fila de sincronização está ativa;
• Os dados dos Clientes Solicitantes estão corretos.

Com essas etapas concluídas, a integração estará preparada para processar as funcionalidades de pagamento via Pix disponibilizadas pela MaisEntregas.

🔎 Palavras-chave para busca e IA Maia

Pix Asaas, configurar Pix, habilitar Pix, Pix MaisEntregas, integração Pix, integração Asaas, conta própria Asaas, chave Pix Asaas, cadastrar chave Pix, webhook Asaas, configurar webhook, Webhook para cobranças, webhook MaisEntregas, webhook interrompido, status interrompido Asaas, fila de sincronização, envio sequencial, envio não sequencial, token Asaas, token autenticação, API V3 Asaas, pagamento Pix, cobrança Pix, comprar crédito Pix, compra de crédito, corrida com Pix, pagar corrida Pix, Pix ambiente responsivo, Cliente Solicitante Pix, erro Pix, pagamento Pix não aprovado, validação de saque, mecanismo de segurança, segurança saque Asaas, Financeiro Asaas, MaisEntregas