---
title: Conectar Stripe para pagamentos
description: 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

1. Abra **Projeto → Apps**.
2. Encontre **Stripe** em **Apps da loja**.
3. Selecione **Conectar**. O Runner abre Stripe em uma nova janela.
4. Complete apenas as etapas mostradas pelo Stripe.
5. Retorne ao Runner e reabra Apps.
6. 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.
7. 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.
8. 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.

## Guias relacionados

- [Conectar, gerenciar e reconectar um aplicativo](./connect-manage-reconnect)
- [Solucionar problemas de conexão de aplicativo](./troubleshooting)
- [Visão geral de aplicativos e integrações](../apps-and-integrations)