O Stripe é um dos processadores de pagamento mais utilizados no mundo e se integra nativamente à Marketek. Com ele, você pode receber pagamentos únicos, assinaturas recorrentes e parcelamentos diretamente pela plataforma. Neste guia, você aprenderá a conectar, configurar e solucionar os problemas mais comuns da integração.
Pré-requisitos
Antes de iniciar a configuração, verifique se:
- Você possui uma conta ativa no Stripe (stripe.com).
- Sua conta Stripe está verificada (documentos enviados e aprovados).
- Você tem acesso de administrador tanto no Stripe quanto na Marketek.
- A moeda configurada no Stripe é compatível com a que você pretende usar na Marketek.
Conexão Passo a Passo
📌 Passo 1: Acessar Integrações de Pagamento
Na Marketek, navegue até Configurações > Pagamentos > Integrações. Clique em Stripe.
📌 Passo 2: Autorizar a Conexão
Clique em Conectar com Stripe. Você será redirecionado para a página de autorização do Stripe. Faça login na sua conta Stripe e clique em Autorizar para conceder acesso à Marketek.
📌 Passo 3: Confirmar a Conexão
Após a autorização, você será redirecionado de volta à Marketek. O status da integração deve aparecer como Conectado com um indicador verde.
💡 Dica: Se a conexão falhar, limpe os cookies do navegador e tente novamente. Certifique-se de que pop-ups não estão sendo bloqueados durante o redirecionamento.
Configurando Webhooks
Os webhooks são essenciais para que o Stripe notifique a Marketek sobre eventos de pagamento (cobrança confirmada, assinatura cancelada, falha de pagamento etc.).
Na maiória dos casos, os webhooks são configurados automaticamente durante a conexão. Porém, se necessário configurar manualmente:
- Acesse o Dashboard do Stripe > Developers > Webhooks.
- Clique em Add Endpoint.
- Insira a URL de webhook fornecida pela Marketek (disponível em Configurações > Pagamentos > Stripe > Webhook URL).
- Selecione os eventos relevantes: checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.deleted.
- Salve e copie o Webhook Signing Secret para inserir na configuração da Marketek.
Testando com o Modo de Teste do Stripe
Antes de aceitar pagamentos reais, valide toda a configuração usando o modo de teste:
- No Stripe Dashboard, ative o Test Mode (botão no canto superior direito).
- Na Marketek, certifique-se de que a integração está apontando para as chaves de teste do Stripe.
- Use o cartão de teste 4242 4242 4242 4242 (qualquer data futura e qualquer CVC) para simular compras.
- Verifique se o acesso ao produto é liberado corretamente após o pagamento de teste.
Ativando em Produção
Após validar no modo de teste:
- No Stripe, desative o Test Mode para voltar ao modo live.
- Na Marketek, reconecte a integração com as chaves de produção (live keys) se necessário.
- Faça uma transação real de valor baixo para confirmar que tudo funciona em produção.
Problemas Comuns e Soluções
| Problema | Causa Provável | Solução |
|---|---|---|
| Webhooks não estão sendo recebidos | URL incorreta ou endpoint inativo | Verifique a URL do webhook na Marketek e confirme que o endpoint está ativo no Stripe. Teste enviando um evento de teste pelo painel do Stripe. |
| Pagamento processado mas acesso não liberado | Webhook não configurado ou oferta não vinculada | Confirme que os webhooks estão ativos e que o produto na Marketek tem a ação pós-compra configurada corretamente. |
| Erro de moeda (currency mismatch) | Moeda do produto diferente da conta Stripe | Certifique-se de que a moeda configurada no produto da Marketek é a mesma aceita pela sua conta Stripe. |
| Pagamento recusado | Problema no cartão do cliente ou regras do Stripe | Oriente o cliente a verificar o cartão. Consulte o log de pagamentos no Stripe para ver o motivo exato da recusa. |
| Assinatura não cancela ao revogar acesso | Ação de cancelamento não configurada | Configure uma automação na Marketek que cancele a assinatura no Stripe quando o acesso for revogado, ou cancele manualmente pelo painel do Stripe. |
Dicas Finais
- Ative notificações de falha: configure alertas no Stripe para ser notificado sobre cobranças falhadas em tempo real.
- Use cupons e descontos: crie cupons no Stripe e aplique-os nas ofertas da Marketek para campanhas promocionais.
- Monitore disputas: acompanhe chargebacks no painel do Stripe e responda dentro do prazo para evitar perdas.
⚠️ Importante: Nunca compartilhe suas chaves secretas do Stripe (Secret Key) publicamente ou em canais não seguros. Essas chaves permitem acesso total à sua conta de pagamentos.
🤖 Ficou com alguma dúvida?
Converse com o TekBot, nosso assistente IA especialista em Marketek. Ele pode te ajudar com configurações, dúvidas técnicas e melhores práticas — 24h por dia.