A maneira mais fácil: faça login com Stripe
Não há chaves para procurar, nada para colar. Você entra em Stripe, aprova Coin Moebius e volta em cerca de um minuto. Coin Moebius mantém apenas o ID da sua conta Stripe, nunca suas chaves, e Stripe nos informa no momento em que algo sobre sua conta muda.
- Abra Provedores e clique em Connect a provider
No painel Coin Moebius, escolha Provedores no menu esquerdo e clique em Connect a provider no canto superior direito.
Coin Moebius → Provedores → Connect a provider - Escolha Stripe
Digite Stripe na caixa de pesquisa ou role para baixo até ela e clique nela.
Connect a provider → Stripe - Dê um nome, adicione suas duas páginas e salve
Dê um apelido à conexão. Insira seu URL de sucesso (a página que um comprador vê após pagar) e seu URL de cancelamento (a página que ele vê se desistir). Fique na primeira guia e clique em Save and connect with Stripe.
Apelido, URL de sucesso, URL de cancelamento → Save and connect with Stripe Ambos os endereços devem começar com https://. Eles são as únicas coisas que você digita nesta tela.
- Aprovar em Stripe
Stripe abre. Faça login em sua conta Stripe ou crie uma ali mesmo, se ainda não tiver uma, e aprove Coin Moebius. Stripe mostra qual conta você está prestes a usar, para que você possa verificar antes de dizer sim.
Stripe → entre ou crie uma conta → aprove Coin Moebius - Você está de volta e conectado
Stripe envia você diretamente de volta para Coin Moebius. Um cheque verde significa que os pagamentos com cartão estão prontos, e o cartão Stripe agora está na página do seu Provedor marcado como Verificado e Ativo.
De volta a Coin Moebius: Stripe conta conectada Provedores → seu cartão Stripe: verificado, ativo Viu "Ação necessária" em vez da marca verde? Stripe não terminou de limpar sua conta para pagamentos com cartão. Termine o que Stripe pede, volte e clique em Verify no cartão Stripe.
A outra maneira: cole suas próprias chaves
Tudo daqui para baixo é o caminho manual. Você configura um webhook em seu painel Stripe, coleta três valores lá e cola-os em Coin Moebius. Planeje cerca de dez minutos. Se você fez login acima, já terminou e pode pular tudo isso.
O que você precisa
| Campo | O que faz |
|---|---|
| Chave publicável (pk_…) | Chave pública que abre o Checkout no navegador. Não é secreta. |
| Chave secreta (sk_…) | Permite criarmos a sessão de Checkout para que a cobrança corra pela sua conta. Secreta. |
| Segredo de assinatura do webhook (whsec_…) | Confirma que um webhook realmente veio do Stripe. Secreto. |
| URL de sucesso / URL de cancelamento | Onde o comprador chega depois de pagar ou desistir. |
Somente o caminho principal precisa disso. Se você fez login com Stripe acima, não há nada para coletar. Stripe mantém chaves separadas para modo Teste e Live (pk_test_ / sk_test_ versus pk_live_ / sk_live_), cada uma com seu próprio segredo de assinatura de webhook. Coin Moebius é mantido nas guias Ativo e Teste, para que você possa verificar as chaves de teste e adicionar chaves ativas posteriormente sem inserir tudo novamente.
Por que pedimos cada campo
Chave publicável
Identifica a sua conta quando o checkout abre no navegador do comprador. Pública por design.
Chave secreta
A metade privada que autoriza a criação da cobrança, para que o pagamento corra pela sua conta.
Segredo de assinatura do webhook
Comprova que um webhook recebido é genuinamente do Stripe, para que ninguém possa forjar um evento de "pago". É um valor separado da chave secreta.
URL de sucesso e cancelamento
Configurações simples: onde o comprador chega depois de pagar ou desistir. Não são secretas.
Configurar
- Use o modo de teste (gratuito)
Uma conta Stripe é gratuita, e o modo de teste funciona antes da ativação. Entre em dashboard.stripe.com e ative o modo de teste (canto superior). Configure no teste primeiro, depois repita na produção.
- Copie as suas chaves
Vá até Developers → API keys e copie a Chave publicável e a Chave secreta.
Stripe → Developers → API keys - Adicione o webhook
- Developers → Webhooks → Add endpoint.
- Defina a URL do endpoint como o endereço de webhook do seu projeto (abaixo).
- Selecione eventos. Para pagamentos únicos: checkout.session.completed, charge.refunded, charge.dispute.created. Se você vende assinaturas, também: customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment_succeeded, invoice.payment_failed. Eventos extras são inofensivos, ignoramos o que não usamos.
- Copie o Signing secret do endpoint (whsec_…). Teste e produção têm cada um o seu.
https://api.coinmoebius.com/webhook/stripe/<your project id>Stripe → Developers → Webhooks → Add endpoint - Teste
Os cartões de teste funcionam apenas no modo de teste e nunca cobram um cartão real. Use qualquer validade futura, qualquer CVC, qualquer código postal.
Resultado Cartão Bem-sucedido 4242 4242 4242 4242 Precisa de autenticação 4000 0025 0000 3155 Recusado 4000 0000 0000 9995 - Conecte no painel
Adicionar provedor → Stripe. Insira a chave publicável, a chave secreta, o segredo de assinatura do webhook, a URL de sucesso, e a URL de cancelamento. Use chaves de teste para verificar o fluxo, depois edite o provedor e troque pelas chaves de produção.
Depois de conectar
Faça um pagamento antes de entrar no ar:
- Entrou com Stripe? Sua conta está ativa, então compre um produto de um dólar com seu próprio cartão e reembolse-o de Stripe posteriormente. Chaves de teste coladas? Cada pagamento é um pagamento de teste, então use um cartão de teste acima.
- Crie um produto e coloque o botão de compra em uma página (um arquivo HTML local serve) apontado para o seu projeto.
- Finalize a compra com um cartão de teste de cima.
- Abra a aba Transações. Quando o status da nova linha chegar a succeeded, as suas chaves e o webhook estão ambos funcionando de ponta a ponta.
Se você usou chaves de teste, edite o provedor, troque suas chaves ativas e você receberá pagamentos reais.
Solução de problemas
Comece com Verify. No painel, clique em Verify no cartão Stripe. Ele pergunta a Stripe sobre sua conta ou verifica suas chaves e retorna uma mensagem específica se algo estiver errado.
Entrei com Stripe e recebi "Conta conectada. Ação necessária".
Sua conta Stripe está conectada, mas Stripe ainda não a liberou para pagamentos com cartão. Abra Stripe, conclua o que ele pede (geralmente detalhes comerciais ou uma conta bancária) e clique em Verify no cartão Stripe em Coin Moebius.
O cartão Stripe diz Desconectado.
Coin Moebius foi removido da sua conta Stripe, geralmente na página Aplicativos autorizados em Stripe. Abra o cartão, escolha Edit e clique em Reconnect para aprová-lo novamente.
A verificação diz que o formato da chave está errado.
As chaves secretas começam com sk_test_ ou sk_live_ (chaves restritas começam com rk_). O segredo de assinatura do webhook começa com whsec_. Copie de novo o valor certo no campo certo.
A verificação diz que o Stripe rejeitou a chave.
Copie de novo a chave secreta em Developers → API keys, e certifique-se de não estar pareando uma chave de teste com um segredo de webhook de produção ou o contrário.
O pagamento se conclui mas o pedido fica pendente.
O webhook não está chegando. Confirme que a URL do endpoint coincide exatamente, que você selecionou checkout.session.completed, e que um pagamento de teste está atingindo o seu endpoint de modo de teste (teste e produção são endpoints separados).
A verificação de assinatura falha.
Cada endpoint do Stripe tem o próprio segredo de assinatura. Copie o whsec_ das configurações deste endpoint, não de outro endpoint.
Confirme de ponta a ponta.
O Stripe não tem um botão de simular. No Painel do Stripe, reenvie um evento recente para o seu endpoint, ou crie um PaymentIntent de teste, depois observe o pedido atualizar.
Bom saber
Conectado com Stripe. Não há chaves ou segredos de webhook para copiar, armazenar ou girar. Stripe avisa Coin Moebius quando sua conta muda. Para cortar o link, clique em Disconnect no cartão Stripe ou remova Coin Moebius em Aplicativos autorizados em Stripe.
Rotacionando chaves. Colou suas próprias chaves? Role a chave secreta ou o segredo do webhook a qualquer momento e cole o novo valor. Os campos secretos ficam em branco na edição para que você possa inserir uma chave girada.
Ativação. As chaves de produção funcionam apenas quando a sua conta está ativada para pagamentos. As chaves de teste funcionam imediatamente.
Dúvidas? Join our Discord