Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

O Conector do Stripe tem suporte apenas para usuários Starter, Core e Pro. Não está disponível em Team Workspaces no momento.

O que você pode criar

Use o Agent para adicionar o Stripe ao seu app com um clique — sem configuração necessária. Crie uma loja, aceite pagamentos únicos ou crie assinaturas. O Agent configura a integração, os modelos de dados e o ambiente de teste.

Como funciona

O Agent começa com um sandbox do Stripe para que você possa testar pagamentos com segurança sem movimentar dinheiro real. Você pode criar e experimentar fluxos imediatamente. Quando estiver pronto, mude para sua conta do Stripe em produção para publicar e aceitar pagamentos reais.
Um sandbox do Stripe é um ambiente de teste isolado onde você pode simular pagamentos, assinaturas e eventos. Saiba mais na documentação do Stripe sobre sandboxes.

Começar

  • Pedir ao Agent para usar o Stripe
    • Use um comando de barra na tela inicial e selecione Stripe, ou pergunte diretamente:
A integração com o Stripe requer um App com funcionalidade de backend. Selecione App na página inicial para começar.

Testar pagamentos no sandbox

  1. Abra o Preview do seu app em uma nova aba.
  2. Faça uma compra de teste na sua loja ou página de pagamento.
  3. Use o cartão de teste padrão do Stripe:
Número do cartão: 4242 4242 4242 4242
Validade: qualquer data futura
CVC: qualquer 3 dígitos
Nome, endereço: quaisquer valores fictícios
As compras no sandbox não são processadas por redes reais e não movimentam dinheiro. São seguras para testes completos.

Gerenciar produtos e preços

Você tem duas opções:
  1. No seu app, selecione Publicar e, em seguida, escolha reivindicar seu sandbox do Stripe.
    • Se você ainda não tiver uma conta do Stripe, crie uma para reivindicar o sandbox.
  2. No Painel do Stripe, abra Produtos para adicionar ou editar produtos e preços. As alterações feitas no sandbox do Stripe são refletidas no seu app do Replit automaticamente e sincronizadas com o banco de dados do seu app.

Visualizar dados sincronizados do Stripe

  • No Project Editor, abra Database.
  • Selecione MyData.
  • Altere o seletor de esquema para Stripe para ver os objetos de pagamento e registros relacionados.

Entrar em produção

Para aceitar pagamentos reais:
Antes de publicar:
  • Instale o app Replit Integrated Payments na sua conta do Stripe em produção (necessário para sincronização do sandbox para produção)
  • Conclua a verificação KYB do Stripe e adicione suas chaves de API em produção
Sua integração com o sandbox não está pronta para produção. Não é possível aceitar pagamentos reais até que você conclua essas etapas.
  1. No Stripe, mude do sandbox para sua conta em produção.
  2. Conclua a verificação KYB (Conheça seu Negócio) do Stripe se solicitado.
  3. Copie suas chaves Publicável e Secreta em produção do Stripe.
  4. No Replit, abra o painel Publicar e adicione suas chaves em produção.
  5. Publique seu app.

Gerenciar a integração

  • Acesse Integrações > Stripe para abrir o conector do Stripe.
  • A partir daí, você pode testar a conexão, visualizar o status e gerenciar as configurações.

Perguntas frequentes

Como faço para atualizar os preços dos meus produtos?

  • Pergunte ao Agent: Descreva a alteração e o Agent atualiza seu app e os objetos do Stripe.
  • Use o Painel do Stripe: Abra Produtos para editar preços e detalhes de produtos.
    • No sandbox, as alterações são sincronizadas de volta para o seu app e banco de dados automaticamente.
    • Para produção, mude primeiro para sua conta em produção e, em seguida, atualize os preços. Publique novamente se seu app precisar incluir a nova configuração.

Como faço para testar transações no Replit?

Abra o Preview do seu app em uma nova aba. Execute o fluxo do Stripe Checkout com o cartão de teste padrão (4242 4242 4242 4242), qualquer validade futura e qualquer CVC. Veja Testar pagamentos no sandbox acima para mais detalhes.

O que é uma conta do Stripe em produção?

Uma conta do Stripe em produção é uma conta ativada e verificada que pode processar pagamentos reais usando os detalhes do seu negócio. Veja a orientação do Stripe sobre criação e ativação de conta: Crie e gerencie sua conta do Stripe.

Como faço para encontrar minhas chaves em produção?

  1. No Painel do Stripe, mude para sua conta em produção usando o seletor de conta (canto superior esquerdo).
  2. No canto inferior esquerdo, selecione Desenvolvedores > Chaves de API.
  3. Revele suas chaves em produção ou crie novas. Para instruções passo a passo sobre como criar novas chaves, veja Criar uma chave de API secreta.

Atualizar ou remover a conexão com o Stripe

Se você não estiver pronto para publicar com suas chaves do Stripe em produção, você tem três opções:

Opção A: Usar chaves de API provisórias

Você pode usar chaves provisórias do Stripe que poderá substituir posteriormente.
Chaves provisórias não processarão pagamentos reais. O catálogo e o checkout não funcionarão na sua URL publicada até que você adicione suas chaves do Stripe em produção. Use esta opção apenas para fins de teste.
1

Ir para a aba de publicação

Abra o painel Publicar no Project Editor.
2

Inserir chaves provisórias

Use estes valores:Chave Publicável:
pk_live_abcdef
Chave Secreta:
sk_live_abcdef

Opção B: Remover a integração com o Stripe manualmente

Você pode remover completamente a integração com o Stripe do seu projeto.
1

Abrir seu projeto

Navegue até o projeto com a integração do Stripe que você deseja remover.
2

Abrir uma nova aba e digitar integrações

Busca em nova aba mostrando a opção Integrações para conectar aos serviços nativos e externos do Replit
3

Role até Stripe e selecione Gerenciar

Painel de Conectores mostrando a integração com Stripe com o botão Gerenciar
4

Selecionar o nome do seu projeto

Isso abre os detalhes da conexão.
5

Selecionar Editar

Conta sandbox do Stripe mostrando a Chave Publicável, a Chave Secreta e o botão Editar
6

Selecionar Excluir

Conta sandbox do Stripe com os botões Excluir e Atualizar
7

Pedir ao Agent para remover o código do Stripe

Vá ao chat do Agent e peça ao Agent que remova o código do conector do Stripe da sua aplicação. Isso removerá toda a sua integração com o Stripe.

Opção C: Reverter para um checkpoint anterior à integração com o Stripe

Se você quiser desfazer completamente a integração com o Stripe e retornar a um estado anterior, pode reverter para um checkpoint mais antigo.
1

Abrir seu projeto

Navegue até o projeto com a integração do Stripe que você deseja remover.
2

Abrir uma nova aba e digitar integrações

Busca em nova aba mostrando a opção Integrações
3

Role até Stripe e selecione Gerenciar

Painel de Conectores mostrando a integração com Stripe com o botão Gerenciar
4

Selecionar o nome do seu projeto

Isso abre os detalhes da conexão.
5

Selecionar Editar

Conta sandbox do Stripe com o botão Editar
6

Selecionar Excluir

Conta sandbox do Stripe com o botão Excluir
7

Encontrar um checkpoint anterior à integração com o Stripe

Vá ao chat do Agent e procure um checkpoint criado antes da integração com o Stripe. Selecione o ícone de relógio no canto superior esquerdo do painel de chat para visualizar o histórico de chat mais antigo.
Ícone de relógio para visualizar o histórico de chat e checkpoints
8

Selecionar Reverter aqui

Quando você encontrar um checkpoint adequado, selecione Reverter aqui para restaurar o projeto para esse estado.
Checkpoint com o botão Reverter aqui

Notas e limitações

  • A atividade no sandbox não afeta saldos ou clientes reais.
  • Alguns recursos do Stripe não podem ser testados em sandboxes (por exemplo, preços IC+ e certos fluxos do Connect). Veja as limitações do sandbox do Stripe.