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 Stripe Connector é suportado 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 aplicativo com um clique — sem necessidade de configuração. Crie uma loja, aceite pagamentos únicos ou crie assinaturas. O Agent conecta a integração, os modelos de dados e o ambiente de teste.

Como funciona

O Agent começa com uma 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 Stripe em produção para publicar e aceitar pagamentos reais.
Uma sandbox do Stripe é um ambiente de teste isolado onde você pode simular pagamentos, assinaturas e eventos. Saiba mais em documentação do Stripe sobre sandboxes.

Começar

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

Testar pagamentos na sandbox

  1. Abra a Preview do seu aplicativo 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:
Card number: 4242 4242 4242 4242
Expiry: any future date
CVC: any 3 digits
Name, address: any mock values
As compras na sandbox não são processadas por redes reais nem movimentam dinheiro. São seguras para testar de ponta a ponta.

Gerenciar produtos e preços

Você tem duas opções:
  1. No seu aplicativo, selecione Publish e escolha reivindicar sua sandbox do Stripe.
    • Se você ainda não tem uma conta Stripe, crie uma para reivindicar a sandbox.
  2. No Dashboard do Stripe, abra Products para adicionar ou editar produtos e preços. As alterações feitas na sandbox do Stripe são refletidas automaticamente no seu aplicativo Replit e sincronizadas com o banco de dados do seu aplicativo.

Ver dados sincronizados do Stripe

  • No Editor de Projeto, abra Database.
  • Selecione MyData.
  • Mude o seletor de schema para Stripe para ver objetos de pagamento e registros relacionados.

Entrar em produção

Para aceitar pagamentos reais:
Antes de publicar:
  • Instale o aplicativo Replit Integrated Payments na sua conta Stripe em produção (necessário para sincronização de sandbox para produção)
  • Complete a verificação KYB do Stripe e adicione suas chaves de API de produção
Sua integração sandbox não está pronta para produção. Ela não pode aceitar pagamentos reais até que você conclua essas etapas.
  1. No Stripe, mude da sandbox para sua conta em produção.
  2. Complete a verificação KYB (Know Your Business) do Stripe se solicitado.
  3. Copie suas chaves Publishable e Secret de produção do Stripe.
  4. No Replit, abra o painel Publish e adicione suas chaves de produção.
  5. Publique seu aplicativo.

Gerenciar a integração

  • Vá para Integrations > Stripe para abrir o conector Stripe.
  • A partir daí, você pode testar a conexão, ver o status e gerenciar configurações.

Perguntas frequentes

Como atualizo os preços dos meus produtos?

  • Peça ao Agent: Descreva a alteração e o Agent atualiza seu aplicativo e os objetos do Stripe.
  • Use o Dashboard do Stripe: Abra Products para editar preços e detalhes de produtos.
    • Na sandbox, as alterações são sincronizadas de volta para seu aplicativo e banco de dados automaticamente.
    • Para produção, mude para sua conta em produção primeiro e depois atualize os preços. Publique novamente se seu aplicativo precisar receber a nova configuração.

Como faço transações de teste no Replit?

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

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

Uma conta Stripe em produção é uma conta ativada e verificada que pode processar pagamentos reais usando os dados do seu negócio. Consulte a orientação do Stripe sobre criação e ativação de conta: Create and manage your Stripe account.

Como encontro minhas chaves de produção?

  1. No Dashboard do Stripe, mude para sua conta em produção usando o seletor de conta (canto superior esquerdo).
  2. No canto inferior esquerdo, selecione Developers > API keys.
  3. Revele suas chaves de produção ou crie novas. Para instruções passo a passo sobre como criar novas chaves, consulte Create a secret API key.

Atualizar ou remover a conexão Stripe

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

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

Você pode usar chaves provisórias do Stripe que pode substituir depois.
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 Stripe de produção. Use esta opção apenas para fins de teste.
1

Ir para a aba de publicação

Abra o painel Publish no Editor de Projeto.
2

Inserir chaves provisórias

Use estes valores:Publishable Key:
pk_live_abcdef
Secret Key:
sk_live_abcdef

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

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

Abrir seu projeto

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

Abrir uma nova aba e digitar integrações

Busca de nova aba mostrando a opção Integrations para conectar a serviços nativos do Replit e externos
3

Role para baixo até Stripe e selecione Manage

Painel de conectores mostrando a integração Stripe com o botão Manage
4

Selecione o nome do seu projeto

Isso abre os detalhes da conexão.
5

Selecione Edit

Conta sandbox do Stripe mostrando Publishable key, Secret key e botão Edit
6

Selecione Delete

Conta sandbox do Stripe com botões Delete e Update
7

Pedir ao Agent para remover o código Stripe

Vá ao chat do Agent e peça ao Agent para remover o código do conector Stripe do seu aplicativo. Isso removerá toda a sua integração Stripe.

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

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

Abrir seu projeto

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

Abrir uma nova aba e digitar integrações

Busca de nova aba mostrando a opção Integrations
3

Role para baixo até Stripe e selecione Manage

Painel de conectores mostrando a integração Stripe com o botão Manage
4

Selecione o nome do seu projeto

Isso abre os detalhes da conexão.
5

Selecione Edit

Conta sandbox do Stripe com botão Edit
6

Selecione Delete

Conta sandbox do Stripe com botão Delete
7

Encontrar um checkpoint anterior à integração Stripe

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

Selecione Rollback here

Quando encontrar um checkpoint adequado, selecione Rollback here para restaurar seu projeto a esse estado.
Checkpoint com o botão Rollback here

Notas e limitações

  • A atividade na 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 Connect). Consulte as limitações de sandbox do Stripe.