Integração Stripe + PIX: Aceite Pagamentos Internacionais no Brasil

O desafio: aceitar pagamentos do Brasil e do mundo

Se você tem um negócio digital no Brasil que atende (ou quer atender) clientes internacionais, já enfrentou esse problema: como aceitar PIX para brasileiros e cartão internacional para estrangeiros, sem ter dois sistemas completamente separados?

A resposta está na combinação de Stripe (para pagamentos internacionais) com PIX (para pagamentos domésticos). Neste artigo, vamos mostrar como arquitetar essa integração, os desafios técnicos e como manter tudo reconciliado.

Por que Stripe + PIX?

Cada método tem sua força:

• PIX: Pagamento instantâneo, sem chargebacks, taxas baixas (R$0,49-1,5% via PSPs). Dominante no Brasil — 150M+ de usuários. Essencial para qualquer negócio que vende para brasileiros.
• Stripe: Aceita cartões de crédito de mais de 135 países, com suporte a Apple Pay, Google Pay e dezenas de métodos de pagamento locais. Dashboard completo, API impecável, e recentemente adicionou suporte a PIX no Brasil.

A combinação permite que você ofereça a melhor experiência para cada público: PIX para quem está no Brasil (que prefere pagamento instantâneo e sem taxas) e Stripe para clientes internacionais (que pagam com cartão).

Arquitetura da integração

Existem duas abordagens principais:

Abordagem 1: Stripe para tudo (incluindo PIX)

Desde 2023, Stripe oferece PIX como método de pagamento no Brasil. Isso significa que você pode usar uma única integração (Stripe) para processar tanto cartões internacionais quanto PIX.

Vantagens:

• Uma única API, um único dashboard, uma única reconciliação
• Menos código para manter
• Stripe gerencia a geração de QR codes e confirmação

Desvantagens:

• Taxa do Stripe sobre PIX é mais alta que PSPs dedicados (Stripe cobra ~1,5% vs Asaas a R$0,49 fixo)
• Para volume alto de PIX doméstico, o custo é significativo
• Menos flexibilidade em features específicas de PIX (cobranças recorrentes, split)

Abordagem 2: Stripe + PSP dedicado para PIX

Use Stripe para cartões internacionais e um PSP brasileiro (Asaas, Mercado Pago, PagSeguro) para PIX. É mais complexo, mas mais econômico em volume.

Vantagens:

• Menor custo por transação PIX
• Features avançadas de PIX (split de pagamento, cobranças recorrentes)
• Melhor suporte para o mercado brasileiro

Desvantagens:

• Duas integrações para manter
• Reconciliação entre dois sistemas
• Lógica de roteamento no seu backend

Implementação prática

Vamos focar na Abordagem 2, que é o que implementamos no BizBiz e em outros projetos. O fluxo funciona assim:

1. Detecção do método de pagamento

Quando o cliente chega no checkout, o sistema detecta a localidade (via idioma do navegador, IP ou seleção manual) e oferece as opções adequadas:

• Cliente brasileiro: PIX (prioridade) + cartão de crédito via Stripe
• Cliente internacional: Cartão de crédito via Stripe + outros métodos locais

2. Roteamento no backend

O backend recebe o pedido e roteia para o gateway correto:

• Se o método é PIX → chama a API do PSP (ex: Asaas) → retorna QR code
• Se o método é cartão → chama a API do Stripe → retorna Payment Intent

O pedido no seu banco de dados armazena tanto o ID interno quanto o ID do gateway (Stripe charge ID ou Asaas payment ID), permitindo rastreamento cruzado.

3. Webhooks unificados

Este é o ponto mais crítico. Seu sistema recebe webhooks de dois gateways diferentes, mas precisa atualizar o mesmo pedido:

• Endpoint para Stripe: /api/webhooks/stripe — recebe eventos como payment_intent.succeeded
• Endpoint para PSP: /api/webhooks/pix — recebe eventos como PAYMENT_RECEIVED

Ambos os endpoints convergem para a mesma lógica: encontrar o pedido pelo ID do gateway, atualizar o status para "pago" e disparar ações subsequentes (enviar e-mail, liberar acesso, etc.).

4. Validação de webhooks

Nunca confie em um webhook sem validar sua autenticidade:

• Stripe: Valide a assinatura do webhook usando o Webhook Secret. O SDK do Stripe (stripe.webhooks.constructEvent) faz isso automaticamente.
• PSP (Asaas): Valide o token enviado no header da requisição. Alguns PSPs também oferecem assinatura HMAC.

Reconciliação: o detalhe que ninguém fala

Com dois gateways, reconciliação se torna essencial. Recomendamos:

• Reconciliação diária automatizada: Um job que roda toda manhã, compara os pagamentos recebidos nos gateways com os registros no seu banco de dados. Qualquer divergência gera um alerta.
• Tabela unificada de transações: No banco de dados, uma tabela transactions com campos para gateway (stripe/pix), gateway_id, amount, currency, status. Isso facilita relatórios e auditoria.
• Alertas de falha: Se um webhook não chega em 5 minutos após a criação do pagamento, o sistema alerta a equipe. Webhooks podem falhar — seu sistema precisa ser resiliente.

Questões de moeda e câmbio

Quando você vende em BRL (para brasileiros via PIX) e USD/EUR (para internacionais via Stripe), precisa considerar:

• Precificação: Defina preços em cada moeda separadamente. Não converta automaticamente — a variação cambial pode corroer sua margem.
• Recebimento: Stripe deposita em USD ou na moeda local da sua conta. PSPs brasileiros depositam em BRL. Você terá dois fluxos de caixa.
• Contabilidade: Trabalhe com seu contador para definir como registrar receitas em moedas diferentes. No Brasil, a receita em moeda estrangeira precisa ser convertida para BRL na data do recebimento.

Custos da integração dual

• Stripe: 3,25% + R$0,39 por transação com cartão internacional. Sem mensalidade.
• PSP para PIX (ex: Asaas): R$0,49 por transação PIX. Sem mensalidade para volumes baixos.
• Desenvolvimento: Integração completa com ambos os gateways, webhooks e reconciliação: R$8.000-15.000 dependendo da complexidade do seu checkout.
• Manutenção: APIs de pagamento mudam. Reserve R$1.000-2.000/mês para acompanhar atualizações e resolver edge cases.

Erros que vimos em produção

Ao longo de vários projetos com pagamentos, estes são os erros mais frequentes:

• Webhook não idempotente: Gateways podem enviar o mesmo webhook mais de uma vez. Sua lógica precisa ser idempotente — processar o mesmo evento duas vezes não pode cobrar o cliente duas vezes.
• Timeout no webhook: Se seu endpoint demora mais de 5 segundos para responder, o gateway pode considerar que falhou e reenviar. Processe o webhook rapidamente (valide + salve) e faça o trabalho pesado (e-mail, liberação) em background.
• Não logar pagamentos falhos: Transações recusadas são dados valiosos. Logue tudo — incluindo o motivo da recusa — para análise posterior.
• Confiar no frontend para status: Nunca atualize o status do pedido baseado no que o frontend reporta. Sempre confirme via webhook do gateway.

Precisa integrar Stripe e PIX no seu negócio?

Na Evoris, temos experiência real com integrações de pagamento para o mercado brasileiro e internacional. Do BizBiz a projetos de e-commerce cross-border, sabemos como entregar uma solução robusta.

Quer aceitar pagamentos internacionais? Fale conosco pelo WhatsApp.