Conectar Stripe para pagamentos
Inicie ou continue a integração do Stripe, compreenda os estados de pagamento e desconecte o Stripe com segurança.
Conecte Stripe quando quiser que uma loja Runner publicada aceite pagamentos de clientes. O Runner mostra o estado da conexão, enquanto Stripe coleta e revisa as informações comerciais necessárias para acesso a pagamentos e saques.
Antes de começar
Caminho de entrada: Projeto → Apps → Store Apps → Stripe
Após publicar, o Runner também pode mostrar Conectar Stripe no fluxo pós-publicação da loja. Esse botão abre a mesma jornada de configuração de pagamento.
Você precisa de:
- permissão para gerenciar a conexão do espaço de trabalho;
- as informações comerciais e de identidade que Stripe solicita; e
- um navegador que permita que a janela de configuração do Stripe seja aberta.
A loja pode ser publicada enquanto o checkout ainda está pausado ou em verificação. A URL de uma loja publicada não comprova que os pagamentos estejam disponíveis.
Controles e resultados do Stripe
| Controle ou estado | Por que é útil | O que acontece a seguir |
|---|---|---|
| Conectar | Inicia a integração de pagamento. | O Runner abre um fluxo de configuração hospedado pelo Stripe em uma nova janela. |
| Conectando... | Mostra que o Runner está preparando a conta Stripe ou link de configuração. | A ação permanece indisponível até que o Runner retorne um resultado. |
| Reconectar | Retoma uma conta que existe mas não está pronta. | O Runner abre um link de integração atualizado para a conta existente. |
| Revisão pendente | Mostra que Stripe está revisando os detalhes enviados. | O rótulo é informativo; siga qualquer aviso de ação separado. |
| Ações do Stripe necessárias | Lista informações ou verificação que precisa de atenção. | Revise os detalhes Pendente agora, Pendente depois, Em revisão, Pagamentos pausados ou Repasses pausados. |
| Continuar integração | Completa os requisitos pendentes do Stripe. | O Runner abre Stripe para a conta existente. |
| Ícone Abrir painel do Stripe | Permite que você gerencie uma conta ativada no Stripe. | Abre o painel Stripe conectado em uma nova aba. |
| Ícone Excluir | Inicia a desconexão. | Abre Desconectar Stripe? em vez de remover imediatamente. |
| Desconectar | Confirma a remoção do Runner. | O Runner desconecta Stripe do espaço de trabalho. Pedidos existentes não são afetados. |
Conectar Stripe
- Abra Projeto → Apps.
- Encontre Stripe em Apps da loja.
- Selecione Conectar. O Runner abre Stripe em uma nova janela.
- Complete apenas as etapas mostradas pelo Stripe.
- Retorne ao Runner e reabra Apps.
- Confirme que o cartão mostra seus controles conectados e que o Runner relata a configuração de pagamento como pronta antes de esperar que o checkout aceite pagamentos.
- Se você vir Reconectar, Continuar integração, Revisão pendente ou Ações do Stripe necessárias, siga esse estado em vez de começar novamente.
- Teste o checkout da loja publicada apenas depois que o Runner relatar que a configuração de pagamento está pronta.
Compreender o resultado
| Estado | O que significa para você |
|---|---|
| Não conectado | O checkout ainda precisa de um provedor de pagamento. |
| Reconexão necessária | Uma conta Stripe existe, mas sua autorização ou integração está incompleta. |
| Revisão pendente | Stripe recebeu os detalhes mas não tornou a conta pronta. |
| Ações necessárias | Stripe precisa de informações específicas, ou pagamentos ou saques podem estar pausados. |
| Conectado | O Runner reconhece a conexão Stripe. Verifique o checkout da loja publicada antes de anunciar que os pagamentos estão disponíveis. |
Desconectar ou reconectar
Para desconectar, selecione o ícone de exclusão, leia Desconectar Stripe? e escolha Desconectar. A confirmação afirma que os pedidos existentes permanecem. Os novos pagamentos de checkout podem permanecer indisponíveis até que uma conexão de pagamento utilizável seja restaurada.
Para reconectar, selecione Reconectar ou Continuar integração. O Runner reutiliza a conta existente quando possível; não crie uma segunda configuração simplesmente porque a primeira janela do provedor foi fechada.
Se Stripe não se conectar
- Se a janela de configuração fechar cedo, retorne a Apps e use Reconectar.
- Se o Runner mostrar Ações do Stripe necessárias, complete os requisitos do provedor listados.
- Se a conta permanecer Revisão pendente, não crie repetidamente novas tentativas de integração.
- Se o Runner mostrar um erro de conexão ou link, tente novamente no cartão Stripe após confirmar que seu navegador permite a nova janela.
- Nunca envie documentos de identidade, IDs de conta ou detalhes de pagamento no chat do Runner.