Como integrar a Stripe?

Como integrar essa adquirente?Atualizado em 2026-06-26

Veja como conectar a Stripe à Cloudfy Checkout para aceitar pagamentos internacionais.

Localizar a Stripe na Cloudfy

Acesse sua conta na Cloudfy, vá em Adquirentes, pesquise por Stripe e clique nela. O sistema pede a Public Key e a Secret Key.

Obter as chaves na Stripe

Na sua conta Stripe, vá em Desenvolvedores → Chaves de API, copie as chaves e cole-as nos campos correspondentes na Cloudfy. Antes de salvar, copie também a URL do webhook exibida na tela.

Cadastrar o webhook na Stripe

Na Stripe, ainda em Desenvolvedores, vá para a aba Webhooks e clique em adicionar destino. Selecione exatamente estes cinco eventos:

  • charge.dispute.created
  • charge.refund.updated
  • payment_intent.succeeded
  • refund.created
  • refund.updated

Cole a URL copiada da Cloudfy no campo de URL e crie o destino.

Salvar e selecionar a Stripe

Volte à Cloudfy, salve as alterações e selecione a Stripe para os métodos de pagamento desejados, como o cartão de crédito.

Criar produto e plano para testar

Crie um produto (físico ou digital) informando nome (inclusive como aparecerá na Stripe), logo, descrição e arquivos entregáveis. Depois, em Loja → Planos, selecione o produto e defina valor, nome do plano e a slug personalizada. Copie o link e faça um pagamento de teste — a transação deve aparecer na aba de transações da sua conta Stripe.

Testar no ambiente de testes da Stripe

Caso queira testar no ambiente de testes da Stripe, pegue as chaves (Public Key e Secret Key) no ambiente de testes da Stripe e cadastre-as na Cloudfy. Para realizar o pagamento de teste, use um cartão de teste:

  • Número do cartão: 4242 4242 4242 4242 (informe no Dashboard ou no formulário de pagamento).
  • Data de validade: qualquer data futura válida, como 12/34.
  • CVC: qualquer três dígitos (quatro dígitos em cartões American Express).
  • Demais campos: qualquer valor.
Lembre-se: chaves de teste só funcionam com cartões de teste, e chaves de produção só com cartões reais. Não misture os ambientes.