Conectar Stripe

Requisitos

Antes de integrar o Stripe, certifique-se de ter:

• Um aplicativo MGX em funcionamento.
• O projeto MGX já está conectado a um Projeto Supabase. (Saiba mais sobre o Supabase.)
• Produtos criados e os preços correspondentes no seu dashboard do Stripe.

Nota: O modo de visualização não pode ser usado para testar a funcionalidade de pagamento. Publique seu app MGX e altere o Stripe para o Modo de Teste para verificar a integração.

Cartão de teste:

• Número do cartão: 4242 4242 4242 4242
• Data de validade: Qualquer data futura
• CVC: Qualquer número de 3 dígitos

Configuração de pagamento do Stripe

1. Conecte o Supabase

   • Clique no botão do Supabase no canto superior direito do MGX
   • Siga os Guias do Conectar Supabase para selecionar seu Projeto Supabase de destino
   • Depois de conectado, você poderá configurar as definições de pagamento pelo Supabase

2. Descreva seus requisitos de assinatura em linguagem natural

   • Exemplo: Crie um sistema de pagamento que ofereça suporte a três planos de assinatura de US$4,99 por semana, US$14,99 por mês e US$149,99 por ano.

   Após o envio, o Agente MGX gerará botões de configuração. Você precisará preencher pelo menos dois campos.

3. Clique no botão Add Stripe Secret Key

   

   • Insira sua chave secreta do Stripe no campo STRIPE_SECRET_KEY.
   • Para cada plano, insira o ID de preço do Stripe correspondente no campo que termina com PRICE_ID.

   

   Você pode obter sua chave secreta do Stripe aqui: https://dashboard.stripe.com/test/apikeys

   Vá até Catálogo de Produtos > Produtos e obtenha o ID do preço usando um dos seguintes métodos:

   • Na lista "Pricing", clique no botão “More” à direita do preço correspondente e, em seguida, clique em "Copy Price ID".

   

   Você pode clicar diretamente no nome do preço para abrir a página de detalhes e, em seguida, copiar o ID do preço exibido no canto superior direito.

   

   Por fim, cole corretamente cada ID de preço no campo de entrada correspondente.

   

   Nota: Para privacidade e segurança, nunca cole sua chave secreta diretamente no chat do MGX. A exposição pode permitir acesso não autorizado à sua conta Stripe. Em vez disso, use o botão "Add API Key" do MGX para armazená-la com segurança.

4. Clique no botão Add Stripe Webhook Secret Key

   

   • Insira sua Webhook Secret Key

5. Como encontrar a Webhook Secret Key:

   No Stripe, clique em “Developers” no canto inferior esquerdo e depois selecione a opção Webhooks.

   

   Na página de Webhooks, clique no botão "Add destination".

   

   Selecione os eventos de webhook que correspondem às necessidades do seu projeto:

   • checkout.session.async_payment_failed
   • checkout.session.async_payment_succeeded
   • checkout.session.completed
   • checkout.session.expired

   

   Após clicar em "Continue", selecione "Webhook endpoint."

   

   Insira a URL do endpoint do Supabase.

   

6. Como encontrar a URL do seu endpoint do Supabase:

   Clique em View Edge Function no MGX.

   

   • Clique para selecionar a edge function com o sufixo correspondente _webhook.

     

   • No painel Details da edge function correspondente, copie a URL do Endpoint e cole-a no Stripe Event Destination.

     

7. Teste sua integração

   Use o Modo de Teste do Stripe para testar pagamentos.

   Detalhes do cartão de teste:

   • Número do cartão: 4242 4242 4242 4242
   • Qualquer data de validade futura
   • Qualquer CVC de 3 dígitos

FAQ

Por que não consigo testar pagamentos no modo de visualização?

O modo de visualização é executado em um ambiente local, que não fornece uma URL de Webhook acessível publicamente. Você deve publicar seu app para receber eventos do Stripe.

Como faço para alternar para o Modo de Produção?

Você pode desativar o Modo de Teste no Dashboard do Stripe e usar sua Secret Key e Webhook Secret reais.

Como posso verificar se um pagamento de teste foi bem-sucedido?

Depois de concluir um pagamento de teste, acesse a página Payments no Stripe para ver os registros da sua transação de teste.