O que é integração de pagamentos no delivery
A integração de pagamentos no delivery conecta cardápio digital, app, site ou marketplace a um gateway/adquirente para autorizar, capturar e liquidar transações. O cliente escolhe o método, o pedido é confirmado e o lojista recebe o repasse conforme contrato.
Na prática, a integração define se o pedido entra na cozinha no tempo certo. Checkout lento, status ambíguo ou webhook falho geram cancelamento, retrabalho e perda de receita. Uma integração madura trata cada transação como evento único, com status rastreável e logs.
Por que investir
- Menos carrinhos abandonados: checkout curto e métodos locais.
- Mais conversão: Pix, cartão salvo e carteiras digitais.
- Operação previsível: status claros de aprovado, recusado e estornado.
- Menos fraude: regras por valor, dispositivo e histórico.
- Caixa organizado: taxas, repasses e estornos conciliados.
Componentes essenciais
Gateway, adquirente e subadquirente
- Adquirente: credencia e liquida transações de cartão.
- Subadquirente: atende pequenos negócios com regras próprias.
- Gateway: camada técnica que conecta checkout, antifraude e múltiplos adquirentes.
Para delivery, prefira gateway com API estável, sandbox, webhooks confiáveis e split de pagamento.
Checkout e tokenização
Checkout transparente mantém o cliente no app e tende a elevar conversão. Tokenização substitui dados do cartão por um token, reduz exposição e viabiliza compras recorrentes.
Pix, cartão e carteiras
- Pix: confirmação rápida, custo menor e alta adesão.
- Cartão: parcelamento e recorrência.
- Carteiras: conveniência em apps.
- Dinheiro: ainda relevante em regiões específicas.
Modelos de integração
Checkout hospedado
O cliente é redirecionado para a página do provedor. Implantação mais simples, porém com menos controle visual e possível atrito.
Checkout transparente
O formulário fica no app ou site. Exige PCI DSS e tokenização, mas oferece melhor experiência e dados para otimização.
API direta
A loja conversa com adquirente ou gateway via API. Dá controle total do fluxo, mas demanda equipe técnica e monitoramento.
Link de pagamento
Útil para WhatsApp e redes sociais. Rápido de operar, mas menos escalável para alto volume.
Arquitetura recomendada
Fluxo: cliente escolhe itens no app; checkout envia valor e dados tokenizados; gateway consulta antifraude; adquirente autoriza; sistema recebe webhook; pedido muda para pago; cozinha é acionada; conciliação registra liquidação e taxa. Use fila para webhooks, retry com backoff e chave de idempotência por pedido.
Mapeie estados: criado, pendente, autorizado, pago, recusado, cancelado, estornado e chargeback. Nunca confie apenas no retorno síncrono do checkout; confirme via webhook assinado. Se o webhook atrasar, o pedido deve ir para análise, não para produção.
Como implementar em 7 passos
1. Mapeie jornadas: app próprio, site, WhatsApp, marketplace e balcão.
2. Defina métodos por perfil de cliente e ticket médio.
3. Escolha gateway com API, sandbox, webhooks e split.
4. Modele o pedido: itens, taxas, entrega, descontos e estorno.
5. Implemente idempotência para evitar cobrança duplicada.
6. Configure antifraude e captura automática.
7. Teste ponta a ponta: aprovação, recusa, estorno, cancelamento e repasse.
Como escolher gateway
- Suporte a Pix, cartão, carteiras e link.
- API documentada, sandbox e ambiente de testes.
- Webhooks com assinatura, retry e histórico.
- Split de pagamento e múltiplos recebedores.
- Antifraude nativo ou integrável.
- Prazo de repasse e custo total claros.
- Suporte técnico em horário de pico.
Prazos, custos e split
Prazos de repasse variam por método e contrato. Pix costuma liquidar rápido; cartão pode ter D+1, D+30 ou antecipação. Taxas incluem gateway, adquirente, antifraude e plataforma.
No split, a divisão ocorre na transação: lojista, entregador, franquia ou marketplace recebem conforme regra. Documente quem paga taxa, quem assume chargeback e como estornos afetam cada participante.
Segurança e compliance
- Use HTTPS e tokenização; nunca armazene PAN completo.
- Aplique 3-D Secure quando exigido.
- Registre logs de auditoria sem dados sensíveis.
- Segregue funções: quem opera não concilia.
- Acompanhe PCI DSS, LGPD e regras do arranjo.
Conciliação financeira e antifraude
A conciliação cruza pedidos, transações, taxas, estornos e repasses. Automatize para achar divergências em horas, não em dias.
Antifraude eficiente combina limite por valor e frequência, análise de dispositivo e geolocalização, bloqueio de BINs e e-mails descartáveis, além de revisão manual para pedidos de alto risco.
Boas práticas de UX no checkout
- Exiba total com entrega e taxas antes de pagar.
- Salve cartão tokenizado para recompra.
- Mostre status em tempo real e prazo de estorno.
- Ofereça Pix copia e cola e QR code.
- Reduza campos e permita editar antes da confirmação.
- Trate recusa com mensagem clara e alternativa de pagamento.
Integração com WhatsApp e marketplaces
Em WhatsApp, use link de pagamento ou botão nativo com status. Em marketplaces, valide quem processa pagamento, quem assume taxa e como o repasse chega. Evite pedido duplicado quando o cliente paga no app e confirma no chat. Centralize o ID do pedido entre canais e registre a origem da venda.
Checklist de testes
- Aprovação com cartão e Pix.
- Recusa por saldo, fraude e dados inválidos.
- Timeout, retry e webhook duplicado.
- Estorno total e parcial.
- Cancelamento antes e depois da captura.
- Split com múltiplos recebedores.
- Conciliação de taxa e repasse.
- Teste de carga no horário de pico.
Erros comuns
- Ignorar falhas de webhook e deixar pedidos sem status.
- Tratar timeout como pagamento aprovado.
- Esquecer estorno parcial e cancelamento após captura.
- Misturar taxa da plataforma com taxa do gateway.
- Não documentar prazos de repasse e chargeback.
Métricas para acompanhar
- Taxa de aprovação por método.
- Tempo médio de checkout.
- Pedidos pagos sem confirmação.
- Chargeback e fraude por 1.000 transações.
- Divergências de conciliação.
- Custo total de pagamento por pedido.
Conclusão
Integração de pagamentos no delivery é infraestrutura de vendas. Escolha gateway confiável, priorize checkout rápido, automatize conciliação e monitore métricas. O resultado aparece em menos falhas, mais pedidos concluídos e caixa sob controle. Trate pagamento como parte do produto, não como back office.
