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.
Uma loja da Hattery com um banner Elevate Your Style e 3 chapéus em destaque

Exemplo de loja onde os clientes podem navegar pelos produtos e pagar através de um checkout alimentado pelo Stripe

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

Instalando o Stripe pelo chat de IA

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.
Chat de IA com um prompt para criar 3 produtos destacado, ao lado da loja que ele criou

Criando produtos pelo chat

​
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.
Card da integração Stripe com Try a test payment destacado e o número do cartão de teste

Executando um pagamento de teste

​
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.
Página Integrations do dashboard de um app com um card do Stripe marcado como Pending Setup, com a etapa Claim your Stripe sandbox destacada e expandida, mostrando um botão para reivindicar o sandbox e entrar no ar

Reivindicando seu sandbox do Stripe no Base44

​
Passo 5 | Ative os pagamentos ao vivo

Depois que você reivindica seu sandbox, a Base44 ativa os pagamentos ao vivo para você. Quando sua conta do Stripe termina de ser ativada, a Base44 cria suas chaves de API ao vivo automaticamente. Assim, você não precisa mais encontrá-las e colá-las a partir do Stripe. Isso muda seu app do modo de teste para o modo ao vivo, em que cobranças reais são criadas quando os clientes concluem o checkout. Para ativar os pagamentos ao vivo:
  1. Clique em Dashboard no editor do seu app.
  2. Clique em Integrations.
  3. Clique em Stripe.
  4. Abra a etapa Add your live API keys from Stripe. Enquanto sua conta termina de se conectar, você vê Waiting for your Stripe account to finish activating. Isso geralmente acontece automaticamente.
  5. Se o Stripe ainda precisar de mais informações, clique em Resume setup in Stripe e complete os detalhes de cadastro que o Stripe pedir, como informações do negócio e bancárias.
Quando sua conta do Stripe estiver ativa, suas chaves ao vivo são adicionadas automaticamente e seu app começa a aceitar pagamentos reais. Para acompanhar sua receita, transações e assinaturas pelo dashboard do seu app, veja Acompanhando pagamentos no seu app.
Para usar suas próprias chaves, clique em Enter keys manually, cole suas chaves publicável e secreta ao vivo do seu dashboard do Stripe e clique em Save API keys. Os pagamentos que você recebe com essas chaves aparecem na sua lista de Transactions a partir do momento em que você as salva.
Um card de integração do Stripe com as etapas de pagamento de teste e de sandbox concluídas, e a etapa de chaves de API ao vivo aguardando a ativação da conta do Stripe, com as opções Resume setup in Stripe ou Enter keys manually

Ativando os pagamentos ao vivo na Base44

Se você inserir uma chave restrita, ela precisa permitir a leitura da conta e o gerenciamento de webhooks. A Base44 não consegue salvar uma chave sem essas permissões.

​
Configurando fluxos de pagamento

Depois de conectar o Stripe no chat de IA e ativar os pagamentos 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.
Se você planeja publicar seu app na App Store ou no Google Play, não venda conteúdo digital no app mobile, como créditos, assinaturas ou produtos digitais. A Apple e o Google exigem seus próprios sistemas de compra in-app para isso, e os apps da Base44 ainda não os suportam. Saiba o que você pode vender em vendendo no seu app.
Permita que os usuários do seu app 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 os usuários do seu app 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 os usuários do seu app 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 os usuários do seu app 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 os usuários do seu app 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 os usuários do seu app 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 os usuários do seu app 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 os usuários do seu app 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 os usuários do seu app 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 os usuários do seu app 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 aplicam 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 lida automaticamente com pagamentos recorrentes e renovações.
Sim. Uma vez que o Stripe é conectado, os usuários do seu app podem atualizar seus dados de cartão, visualizar faturas e gerenciar assinaturas através do portal de cobrança seguro do Stripe.
A Base44 não tem atualmente uma solução de pagamento integrada para Israel. Você ainda pode aceitar pagamentos conectando o provedor de pagamento da sua escolha como uma integração: peça ao chat de IA para conectar seu provedor, e ele configura a integração para você.
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 mostram 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 as informações mais precisas e atualizadas, consulte a versão em inglês.