Pular para o conteúdo principal
A Base44 permite configurar pagamentos com Stripe diretamente do chat de IA no editor do seu app. Você pode pedir ao chat para instalar o Stripe e criar um fluxo de checkout para seu app. Tudo começa em um ambiente de teste seguro do Stripe, para que você possa executar pagamentos de teste antes de conectar sua conta Stripe ao vivo e adicionar suas chaves de API.
Configurando pagamentos com Stripe no seu app Base44
Esse fluxo foi lançado em janeiro de 2026 e substitui o fluxo antigo do Stripe.

​
Passo 1 | Instale o Stripe

Comece pedindo ao chat do Base44 para instalar o Stripe para seu app. A Base44 configura tudo em um ambiente de teste para que você possa experimentar sem cobranças reais.
Nota: O Stripe está disponível no plano Builder e superiores.
Para instalar o Stripe:
  1. Vá para o editor do seu app.
  2. Peça ao chat de IA para configurar pagamentos no seu app. Por exemplo, você pode perguntar: Conecte um método de pagamento para que eu possa receber pagamentos dos clientes.
  3. Revise a resposta da Base44 descrevendo que ela configurará pagamentos com Stripe para seu app em um ambiente de teste e clique em Install Stripe.
Conectando o método de pagamento do Stripe via o chat de IA no Base44
Quando você tiver instalado o Stripe, vá para Dashboard → Integrations → Stripe para ver o guia de configuração.

​
Passo 2 | Crie seus produtos

Peça ao chat de IA para criar seus produtos. Por exemplo, você pode perguntar ao chat: Crie 3 produtos para minha loja:
  • Boné Classic Baseball – $20
  • Touca Wool Beanie – $25
  • Viseira Sun Visor – $18
Os produtos e preços são criados diretamente no Stripe, e você os verá e gerenciará no seu Stripe Dashboard. Se quiser alterar ou adicionar produtos mais tarde, pode pedir ao chat de IA para fazer isso por você. A Base44 então usa esses produtos e preços do Stripe quando constrói seus fluxos de checkout. Ela não cria um banco de dados de produtos separado para você automaticamente.
Adicionando produtos usando o chat de IA no Base44

​
Passo 3 | Teste seu fluxo de checkout

Depois que o Stripe estiver instalado, você pode testar seu fluxo de checkout usando o cartão de teste do Stripe. Isso ajuda a confirmar que a jornada do cliente, da seleção do produto ao pagamento, se comporta como esperado.
Nota: O fluxo de checkout só roda no seu app publicado, não na pré-visualização do editor. Certifique-se de publicar seu app primeiro, depois abra o site ao vivo para executar seu pagamento de teste.
Para executar um pagamento de teste:
  1. Clique em Dashboard no editor do seu app.
  2. Clique em Integrations.
  3. Clique em Stripe.
  4. Clique em Try a test payment e depois em Copy Card Number para poder colá-lo durante o checkout
  5. Publique seu app.
  6. Passe pelo fluxo de checkout e na etapa de pagamento, insira:
    • O número do cartão de teste
    • Qualquer data de expiração futura
    • Qualquer CVC de 3 dígitos
  7. Conclua o checkout para criar um pagamento de teste.
Testando seu fluxo de checkout com Stripe no Base44

​
Passo 4 | Reivindique seu sandbox do Stripe

Quando estiver satisfeito com como o fluxo de teste funciona, reivindique seu sandbox conectando sua própria conta Stripe ou criando uma nova. Esta etapa vincula o ambiente de teste no Base44 à sua conta Stripe para que você possa avançar em direção a uma configuração ao vivo. Você pode pedir ao chat de IA para reivindicar seu sandbox do Stripe, ou pode fazê-lo você mesmo no dashboard do seu app.
Importante:
  • Você tem 60 dias para reivindicar seu sandbox do Stripe.
  • Certifique-se de conectar a conta Stripe correta para seu negócio. Esta é a conta que recebe seus pagamentos quando você entrar no ar.
Para reivindicar seu sandbox do Stripe:
  1. Clique em Dashboard no editor do seu app.
  2. Clique em Integrations.
  3. Clique em Stripe.
  4. Clique em Claim your Stripe sandbox.
  5. Clique em Claim & Go Live.
  6. Siga as instruções para fazer login na sua conta Stripe existente ou crie uma nova conta Stripe se ainda não tem uma.
  7. Conclua quaisquer detalhes de onboarding que o Stripe solicitar, como informações comerciais e bancárias.
  8. Quando você retornar ao Base44, verifique em Setup para confirmar que a etapa Claim your Stripe sandbox aparece como concluída.
Reivindicando seu sandbox do Stripe no Base44

​
Passo 5 | Adicione suas chaves de API do Stripe

Depois de reivindicar seu sandbox, adicione suas chaves de API do Stripe ao vivo no Base44. Isso transforma o Stripe do modo de teste em uma configuração ao vivo que pode aceitar pagamentos reais dos seus clientes. Uma vez que suas chaves ao vivo são salvas, seu app usa o Stripe no modo ao vivo e cobranças reais são criadas quando os clientes concluem o checkout. Para encontrar suas chaves de API ao vivo no Stripe:
  1. Faça login no seu dashboard do Stripe.
  2. Vá para a página que lista suas chaves de API. Certifique-se de estar visualizando suas chaves ao vivo, não suas chaves de teste.
  3. Copie sua chave publicável ao vivo.
  4. Copie sua chave secreta ao vivo.
Para adicionar suas chaves de API ao vivo no Base44:
Dica: Se você usou o chat de IA para reivindicar seu sandbox do Stripe, também pode adicionar suas chaves de API quando solicitado pelo chat.
  1. Clique em Dashboard no editor do seu app.
  2. Clique em Integrations.
  3. Clique em Stripe.
  4. Clique em Add your live API keys from Stripe.
  5. Cole sua chave publicável ao vivo no campo relevante.
  6. Cole sua chave secreta ao vivo no campo relevante.
  7. Clique em Save API keys.
Adicionando suas chaves de API no Base44 para conectar ao Stripe

​
Configurando fluxos de pagamento

Depois de conectar o Stripe no chat de IA e adicionar suas chaves de API ao vivo, você está pronto para configurar fluxos de pagamento reais no seu app. Cada fluxo deve enviar uma pessoa logada ao Stripe Checkout e, na página de sucesso, confirmar o pagamento e atualizar sua conta enquanto ela ainda está logada, em vez de depender de webhooks sozinhos. Use os prompts de exemplo abaixo no chat de IA e ajuste os detalhes para que correspondam ao que deseja vender e como seu app deve mudar o acesso de alguém depois que pagam. Você pode copiá-los como estão ou ajustá-los para descrever exatamente o que deseja que seu app faça.
Permita que seus usuários comprem créditos (por exemplo, “Compre 10 créditos por $10”) e atualize automaticamente sua conta após o pagamento.
O que digitar no chat:
Quero permitir que meus usuários comprem créditos no meu app usando Stripe.
Após um pagamento bem-sucedido, o usuário deve ser devolvido ao meu app e seus créditos devem ser adicionados à sua conta.
  • Verifique o pagamento com segurança antes de adicionar créditos.
  • Adicione o número correto de créditos à conta do usuário.
  • Certifique-se de que os créditos sejam adicionados apenas uma vez, mesmo se a página for atualizada.
Acompanhamento opcional:
Adicione um botão “Comprar 10 créditos” à minha página inicial.
Permita que seus usuários comprem um item para download e desbloqueiem o acesso após o pagamento.
O que digitar no chat:
Quero vender um produto digital no meu app usando Stripe (por exemplo, um eBook ou curso).
Após um pagamento bem-sucedido, o usuário deve ser devolvido ao meu app e obter acesso ao download ou conteúdo.
  • Registre a compra no meu app.
  • Desbloqueie o acesso do usuário ao produto.
  • Certifique-se de que o mesmo pagamento não possa ser usado para desbloquear o produto várias vezes.
Permita que seus usuários paguem para reservar um horário e salvar o compromisso em sua conta.
O que digitar no chat:
Quero permitir que meus usuários reservem um serviço pago no meu app usando Stripe (por exemplo, uma sessão de yoga ou chamada de coaching).
  • Permita que meus usuários escolham um serviço e horário.
  • Lide com o pagamento com Stripe.
  • Após um pagamento bem-sucedido, salve a reserva (serviço, horário, usuário) em uma coleção de reservas.
  • Mostre uma confirmação clara no app.
  • Evite reserva dupla, mesmo que o usuário atualize a página ou tente confirmar novamente.
Permita que seus usuários se inscrevam em um plano recorrente e marque-os como assinantes.
O que digitar no chat:
Construa um fluxo de assinatura Stripe onde meus usuários podem se inscrever em um plano recorrente.
  • Permita que meus usuários escolham um plano de assinatura no meu app.
  • Lide com o pagamento recorrente com Stripe.
  • Após uma inscrição bem-sucedida, marque o usuário como “Pro” (ou assinante) em sua conta.
  • Armazene os detalhes da assinatura para que eu possa gerenciar cancelamentos ou atualizações de cobrança mais tarde.
Permita que seus usuários cancelem seu plano e rebaixem seu nível de acesso.
O que digitar no chat:Crie um fluxo de cancelamento para assinaturas.
  • Permita que meus usuários cancelem sua assinatura, seja de uma página no meu app ou através do portal do cliente do Stripe.
  • Após um cancelamento, atualize a conta do usuário para que eles percam seu status “Pro” / assinado.
  • Opcionalmente, mostre uma mensagem clara ou redirecione-os para uma página ou plano rebaixado.
Se um reembolso for processado, remova créditos ou bloqueie o acesso ao conteúdo.
O que digitar no chat:
Configure um fluxo seguro para lidar com reembolsos do Stripe.
  • Quando um reembolso for processado, permita que um admin acione uma verificação de dentro do app.
  • Verifique se o pagamento reembolsado pertence ao usuário correto.
  • Revogue o acesso ou subtraia créditos da conta desse usuário.
  • Evite que o mesmo reembolso seja processado mais de uma vez.
Acompanhamento opcional:
Crie uma página de admin onde eu possa inserir um ID de pagamento ou sessão do Stripe, revisar os detalhes e aplicar as alterações relacionadas ao reembolso (como remover acesso ou créditos) manualmente.
Permita que seus usuários comprem um ingresso para um evento único e salvem seu registro.
O que digitar no chat:
Quero vender ingressos para um evento no meu app usando Stripe.
  • Permita que meus usuários comprem um ingresso para um evento específico.
  • Após um pagamento bem-sucedido, salve os detalhes do participante (nome, email, evento) em uma lista ou coleção de participantes.
  • Mostre uma página de confirmação ou agradecimento clara após a compra.
  • Opcionalmente, gere um ingresso simples ou código de confirmação que o participante possa usar no evento.
Permita que seus usuários apoiem seu trabalho ou projeto com um pagamento único ou mensal.
O que digitar no chat:
Crie um fluxo para aceitar doações ou gorjetas no meu app usando Stripe.
  • Permita que meus usuários escolham um valor sugerido (por exemplo, $5, $10, $25) ou insiram um valor personalizado.
  • Lide com o pagamento com Stripe.
  • Após um pagamento bem-sucedido, mostre uma página ou mensagem de agradecimento.
  • Opcionalmente, salve cada doação em uma coleção de Doações vinculada à conta do usuário.
Acompanhamento opcional:
Adicione um botão “Apoie-me” à minha página Sobre que leva os usuários a esse fluxo de doação.
Permita que seus usuários paguem de outros países usando moeda ou métodos locais.
O que digitar no chat:
Configure meus pagamentos Stripe para que funcionem bem para usuários internacionais.
  • Habilite métodos de pagamento internacionais comuns (por exemplo, iDEAL, Bancontact, Apple Pay, Google Pay).
  • Use a conversão de moeda automática do Stripe para que meus usuários possam pagar em sua moeda local.
  • Mostre preços em USD no meu app, mas deixe o Stripe lidar com preços locais no checkout.
  • Certifique-se de que o fluxo de checkout funcione suavemente para usuários em diferentes países.
Permita que seus usuários recebam uma fatura profissional e paguem depois usando uma página hospedada pelo Stripe.
O que digitar no chat:
Configure um fluxo de faturamento do Stripe no meu app.
  • Permita que eu gere e envie uma fatura para um usuário do meu app.
  • Inclua uma descrição, valor e data de vencimento em cada fatura.
  • Envie ao usuário um link de pagamento seguro que ele possa usar para pagar a fatura.
  • Depois que a fatura for paga, atualize o registro do usuário no meu app (por exemplo, marque a fatura como paga ou desbloqueie o acesso).
Acompanhamento opcional:
Adicione um botão “Faturar um cliente” ao meu dashboard de admin que inicia este fluxo.
Permita que seus usuários vendam seus próprios produtos ou serviços e recebam pagamentos diretos.
O que digitar no chat:
Crie um marketplace básico no meu app usando o Stripe Connect.
  • Permita que meus usuários se registrem como vendedores e conectem suas próprias contas Stripe.
  • Quando um cliente compra algo, encaminhe o pagamento para o vendedor correto.
  • Opcionalmente, faça uma pequena taxa de plataforma de cada transação.
  • Acompanhe transações e mostre a cada vendedor seus ganhos e histórico de pagamentos.
O Stripe Connect é mais avançado e pode exigir configuração adicional ou aprovação do Stripe.

​
Perguntas frequentes

Clique em uma pergunta abaixo para saber mais sobre como configurar pagamentos
Não. Quando você segue o passo 2, os pagamentos são criados no modo de teste do Stripe. Você usa o número do cartão de crédito de teste, e nenhum dinheiro real se move entre contas.
Você pode acompanhar todos os pagamentos e reembolsos diretamente no seu Stripe Dashboard.
  • Vá para Payments para ver cobranças individuais e seu status.
  • Vá para Customers para ver um histórico de pagamentos e reembolsos por cliente.
  • Vá para Balance → Transactions para uma visão estilo livro-razão de pagamentos, taxas e ajustes.
Qualquer atividade de pagamento que acontece através do seu app Base44 é registrada lá em tempo real.
Sim. Você pode atualizar produtos e preços no seu Stripe Dashboard a qualquer momento.Essas alterações se aplicarão aos checkouts e assinaturas criados através do seu app Base44. Se seu app armazena IDs específicos de produto ou preço (por exemplo, em seus dados de produto), certifique-se de atualizar essas referências se criar novos preços no Stripe em vez de editar os existentes.
Você não precisa ter um negócio registrado para testar coisas. Você pode usar o modo sandbox (teste) do Stripe sem inserir detalhes reais do negócio. Mas para aceitar pagamentos reais, o Stripe exige informações comerciais e bancárias verificadas.
Uma vez conectado, seu app pode aceitar:
  • Cartões de crédito e débito
  • Apple Pay e Google Pay
  • Métodos de pagamento locais (como iDEAL, Bancontact, etc.)
  • Várias moedas com conversão automática
Sim. Você pode oferecer assinaturas ou associações no seu app Base44 usando Stripe. O Stripe lidará automaticamente com pagamentos recorrentes e renovações.
Sim. Uma vez que o Stripe é conectado, seus usuários podem atualizar seus dados de cartão, visualizar faturas e gerenciar assinaturas através do portal de cobrança seguro do Stripe.
Se o Stripe não está funcionando como esperado no seu app, por exemplo, nada acontece quando um usuário clica em um botão “Pagar” ou “Checkout”, você pode visualizar Function Logs no seu dashboard do Base44 para descobrir o que está dando errado.Isso funciona para qualquer funcionalidade relacionada a pagamentos, esteja você vendendo produtos, aceitando reservas ou oferecendo assinaturas.Veja como verificar os logs:
  1. Clique em Dashboard no editor do seu app.
  2. Vá para Code → Functions.
  3. Encontre a função relacionada ao seu fluxo de pagamento (por exemplo, createCheckout para uma loja).
  4. Clique na função, depois role até a seção Logs.
Os Logs mostrarão mensagens sobre o que aconteceu quando a função foi executada. Procure por mensagens de erro em vermelho — elas podem ajudar a identificar o que deu errado
Exemplo:
Se seu app é uma loja e a função createCheckout falha, os logs podem mostrar:
  • “Product not found” → um dos itens no carrinho está faltando ou tem um ID incorreto
  • “Invalid price” → um produto está sem preço ou definido como 0
  • “Missing success_url” → o Stripe não sabe para onde enviar os usuários depois que eles pagam
  • “API Key invalid” → o Stripe não está conectado corretamente
Uma vez que você encontre a mensagem de erro, pode copiá-la e colá-la no chat de IA para pedir ao seu app Base44 ajuda para corrigi-la.
Se seu fluxo de pagamento não é concluído ou você vê uma página em branco após o pagamento, geralmente é causado pelo ambiente do app ou configurações de redirecionamento. Se está usando Stripe, teste seu fluxo seguindo o passo 3 acima. Se construiu um fluxo de pagamento personalizado ou usa outro provedor, verifique o seguinte:Problemas comuns:
  1. Preview vs publicado: Fluxos de pagamento personalizados geralmente não funcionam corretamente em pré-visualização. Sempre teste pagamentos no seu app publicado, usando a URL ao vivo.
  2. Problemas de URL de redirecionamento: Se você ver loops de redirecionamento ou uma página em branco após o pagamento, verifique se suas URLs de sucesso e cancelamento apontam para seu domínio de app publicado e se você não está misturando URLs de pré-visualização com callbacks de pagamento ao vivo.
  3. Requisitos de login: Se você exige login para acessar seu app ou páginas de pagamento, certifique-se de que a página de sucesso após o pagamento ainda esteja acessível para pessoas logadas. Auth mal configurada pode levar a páginas em branco após o checkout.
  4. Pop up vs mesma janela: No celular, alguns provedores funcionam melhor em uma aba ou pop-up de pagamento separado. Se você ver problemas ao substituir a página atual, considere abrir a página de pagamento em uma nova janela se seu provedor suportar.
Para corrigir o problema:
  1. Verifique o console do seu navegador em busca de erros.
  2. No seu dashboard Base44, vá para Code → Functions e revise os logs para quaisquer funções de backend relacionadas a pagamentos.
  3. Se você usa webhooks, verifique se sua URL de webhook está correta e se o endpoint está implantado e respondendo.
Se ainda não conseguir encontrar a causa, copie quaisquer mensagens de erro do seu console ou logs de função e cole no chat de IA do Base44. Peça para “ajudar a solucionar este fluxo de pagamento passo a passo” e inclua detalhes sobre seu provedor e configuração.
Chamar o Stripe em si não usa créditos de integração do Base44. Quando seu app chama o Stripe usando suas próprias chaves de API através de funções de backend, a requisição vai diretamente da sua função de backend para o Stripe. Os serviços internos da Base44 não estão envolvidos.Os créditos de integração são usados apenas quando seu app usa os serviços internos próprios da Base44.Se seu fluxo de pagamento Stripe também aciona qualquer um desses serviços internos, por exemplo, enviar um email de confirmação via SendEmail da Base44, essas ações específicas consomem créditos de integração normalmente. O Stripe em si não.
Esta página foi traduzida usando IA. Para informações mais precisas e atualizadas, consulte a versão em inglês.