Conecte o Stripe ao seu app do MonstarX

Receba pagamentos com cartão, assinaturas e checkouts no seu app.

Tipo

Para o seu app

Categoria

Pagamentos e cobrança

Conecte com

Chave de API

O Stripe é uma empresa de pagamentos: cuida do formulário do cartão, da parte bancária e dos recibos, e repassa o dinheiro para a sua conta bancária. Conecte-o e o seu app pode vender coisas — um pacote de aulas, um produto, uma mensalidade — com uma página de checkout segura operada pelo Stripe.

O que você pode criar com ele?

• Um botão “Comprar agora” que abre a página de checkout do Stripe e traz o cliente de volta ao seu app depois do pagamento.
• Pacotes e combos, como “5 aulas por $90”, que liberam algo no app depois de pagos.
• Assinaturas mensais ou anuais para membros ou para um plano pago.
• Um histórico de pedidos para cada cliente e uma página de administração com a lista de pagamentos.
• Ações automáticas, como marcar um pedido como pago e enviar um recibo por e-mail, quando o Stripe confirma o pagamento.

Antes de começar

• Uma conta do Stripe. Criar uma é grátis; o Stripe cobra uma taxa de cada pagamento aprovado (veja os preços do Stripe). O MonstarX não cobra nada a mais.
• Para testar, nada além disso: toda conta do Stripe pode usar um sandbox, uma cópia de treino da sua conta em que nenhum dinheiro de verdade circula.
• Para pagamentos reais, o Stripe pede que você ative a conta antes — com os dados da sua empresa e a conta bancária que vai receber.

O que são Sandbox e Produção?

O Stripe dá a você dois conjuntos de chaves, e o MonstarX pergunta qual deles você está colando na opção Ambiente:

Ambiente	As chaves começam com	O que acontece
Sandbox (chaves de teste)	sk_test_… e pk_test_…	Pagamentos de mentira com números de cartão de teste. Nenhum cartão real é cobrado e nenhum dinheiro circula. Use enquanto cria.
Produção (chaves live)	sk_live_… e pk_live_…	Cartões reais, dinheiro real, repassado para o seu banco. Use quando clientes reais forem pagar.

O que você cria em um não existe no outro: produtos, preços, clientes e pagamentos feitos em um sandbox ficam no sandbox.

Como pago com um cartão de teste?

Em um sandbox, o checkout do Stripe aceita os cartões de teste que ele publica. Use qualquer data de validade futura (como 12/34), qualquer CVC de três dígitos e qualquer CEP:

Número do cartão	O que faz
4242 4242 4242 4242	O pagamento é aprovado.
4000 0000 0000 0002	O cartão é recusado, para você ver o que os clientes veem quando um pagamento falha.
4000 0025 0000 3155	O banco pede uma verificação extra (3D Secure) antes de aprovar o pagamento.

Nunca digite um número de cartão real em um checkout de sandbox. O Stripe lista mais cartões de teste no guia de testes.

Pegue suas chaves

1. Entre no Dashboard do Stripe.

2. Para testar, abra um sandbox pelo menu da conta, no canto superior esquerdo. Para ir ao ar, mude para o live mode.

3. Abra API keys (em Developers). Copie a Publishable key, depois revele e copie a Secret key.

Cuidado

A chave secreta consegue cobrar e fazer reembolsos na sua conta. Cole-a só no formulário do conector do MonstarX — nunca no chat, em um e-mail ou no código do seu app. Uma chave secreta live só aparece uma vez, então guarde-a em um lugar seguro.

Conecte no MonstarX

Quando você pede pagamentos, o MonstarX normalmente mostra um cartão Conectar Stripe no chat com os mesmos campos. Você também pode conectar por conta própria:

1. Abra seu projeto e clique em Backend na barra superior e depois em Nuvem.

2. Em Conectores, clique em Conectar ao lado do Stripe.

3. Escolha o Ambiente: Sandbox (chaves de teste) ou Produção (chaves live).

4. Cole a Chave secreta e a Chave publicável. Por enquanto, deixe Segredo de assinatura do webhook em branco.

   

5. Clique em Conectar Stripe. A linha mostra Conectado · sandbox (ou Conectado · produção) e a prévia reinicia com as chaves.

O MonstarX não confere se as chaves combinam com o ambiente escolhido, então garanta que chaves sk_test_ fiquem com Sandbox e chaves sk_live_ com Produção.

Preciso do segredo de assinatura do webhook?

Um webhook é o Stripe avisando o seu app de que “este pagamento foi aprovado”, mesmo que o cliente tenha fechado a página antes de voltar. Apps que liberam algo depois do pagamento, ou que têm assinaturas, devem ter um. Adicione depois que o app estiver publicado, porque o Stripe não consegue acessar a sua prévia privada:

1. Pergunte ao MonstarX: “Qual é o endereço do meu webhook do Stripe e quais eventos ele deve ouvir?” Normalmente é https://your-app.monstarx.app/api/stripe-webhook.

2. No Stripe, abra Webhooks, clique em Create an event destination, escolha esses eventos, selecione Webhook endpoint e cole o endereço.

3. Revele o signing secret (ele começa com whsec_) e copie.

4. No MonstarX, clique em Atualizar chaves na linha do Stripe, cole em Segredo de assinatura do webhook e clique em Salvar chaves. Publique de novo para o app no ar receber o segredo.

O sandbox e o live mode têm cada um os seus próprios webhooks e segredos de assinatura.

Peça ao MonstarX para usar

Você digita	O que acontece
“Deixe os alunos comprarem um pacote de 5 aulas por $90 com o Stripe.”	Um botão de compra, um checkout do Stripe com esse valor e uma página de agradecimento; o pacote é liberado depois do pagamento.
“Adicione um plano Pro mensal de $12 com o Stripe e uma página para eu ver meu plano.”	Um checkout de assinatura e uma página que mostra o plano do membro.
“Adicione uma página de administração que liste todos os pagamentos.”	Uma página com os pagamentos: quem pagou, pelo quê e quando.
“Importe meus produtos do Stripe para a loja.”	O MonstarX precisa das suas chaves para ler a sua conta, então o cartão diz O MonstarX precisa conectar Stripe para continuar e ele segue sozinho assim que você conecta.

Ainda não tem as chaves? Clique em Depois no cartão. O MonstarX cria o checkout inteiro mesmo assim, e o botão avisa que o Stripe ainda não está conectado até você adicioná-las.

Vá ao ar

1. Ative a sua conta do Stripe, mude para o live mode e copie as chaves live.

2. Em Backend›Nuvem, clique em Atualizar chaves na linha do Stripe.

3. Mude o Ambiente para Produção (chaves live), cole as duas chaves live (e um segredo de assinatura de webhook live, se usar um) e clique em Salvar chaves.

4. Publique o app de novo. A partir daí, os pagamentos são reais.

Dica

Faça você mesmo um pagamento real de valor baixo e depois reembolse pelo Dashboard do Stripe. É o jeito mais rápido de conferir se tudo funciona no live mode.

Segurança e privacidade

• Suas chaves ficam guardadas com criptografia só com este app. Os nomes delas aparecem em Backend›Segredos; os valores nunca mais são mostrados.
• A chave secreta e o segredo de assinatura do webhook só são usados pelo servidor do seu app. A chave publicável foi feita para ser vista no navegador, e isso é seguro.
• Os números de cartão são digitados na própria página de checkout do Stripe. Eles nunca chegam ao seu app nem ao MonstarX.
• Só o proprietário do projeto pode conectar, atualizar ou desconectar o Stripe. Desconectar remove as chaves deste app; o checkout passa a mostrar que o Stripe não está conectado.
• Se uma chave vazar, gere uma nova (roll) no Dashboard do Stripe e cole a nova em Atualizar chaves.

Bom saber

• Cada app usa um ambiente do Stripe por vez. Voltar um app no ar para chaves de sandbox interrompe os pagamentos reais até você trocar de novo.
• O Stripe também oferece chaves restritas (rk_…), só com as permissões que você escolher. Elas funcionam no campo Chave secreta se permitirem tudo o que o seu app faz, como criar sessões de checkout.
• Os testes de QA testam um fluxo de pagamento até a etapa do Stripe e o marcam como precisando de chaves enquanto o Stripe não estiver conectado.

Perguntas frequentes

O MonstarX fica com uma parte das minhas vendas?

Não. Os pagamentos vão direto para a sua conta do Stripe. Só as taxas do próprio Stripe se aplicam.

Posso testar pagamentos sem um cartão real?

Sim. Conecte com Sandbox (chaves de teste) e pague com o cartão de teste 4242 4242 4242 4242, qualquer data futura e qualquer CVC. Nenhum dinheiro circula.

Como passo de pagamentos de teste para pagamentos reais?

Clique em Atualizar chaves na linha do Stripe, mude o Ambiente para Produção (chaves live), cole suas chaves live, clique em Salvar chaves e publique de novo.

Por que o meu checkout diz que o Stripe não está conectado?

As chaves ainda não foram adicionadas ou foram removidas. Abra Backend → Nuvem e conecte o Stripe; a prévia reinicia com as chaves.

Consigo ver os pagamentos no MonstarX?

O seu app mostra o que o MonstarX criou para ele, como uma página de pedidos. O registro completo de cada pagamento, reembolso e repasse fica no Dashboard do Stripe.

Veja também

Conecte um serviço ao seu appComo funcionam os conectores do app, os cartões e o Depois.

Publique seu appColoque o app no ar para o Stripe conseguir acessá-lo.

TwilioEnvie um recibo ou um lembrete por SMS aos clientes.

Segredos e chaves de APIOnde as suas chaves ficam guardadas.