# Conectar o Stripe ou o Asaas

Fonte: https://docs.barbeiro.app/business-admin/settings/payments-connect-provider
Perfil: Administrador
Verificado em: 2026-09-06

> Cada provedor conecta de um jeito: o Stripe abre a conta dele e volta, o Asaas pede uma chave que só o computador gera. Desconectar tem regra.

## Conectar o Stripe (passo a passo)

O Stripe usa o botão **Conectar** normal: ele abre o site do Stripe, você entra na sua conta (ou cria uma) e volta para o aplicativo já conectado. A linha do Stripe aparece no degrau **1 · A conta que recebe**, em **Configurações → Pagamentos**, e também na página **Integrações**.

1. Em **Configurações → Pagamentos**, na linha do **Stripe**, toque em **Conectar**. Você é levado
   ao site do Stripe.

2. Entre na sua conta Stripe ou crie uma. O Stripe pede os dados da sua empresa e uma conta
   bancária para receber.

3. Ao voltar, a linha do Stripe mostra **Conectado**. Se o Stripe ainda estiver conferindo seus
   documentos, aparece um aviso pedindo para **terminar o cadastro no Stripe** — enquanto isso ele
   não cobra ninguém.

> **O cliente pode ter que confirmar no banco**
>
> No Stripe, pagamentos com cartão podem pedir a confirmação do cliente no aplicativo do banco (o
> famoso "3D Secure"). Isso é normal e acontece na própria tela de pagamento. Por isso o
> agendamento aparece como **pago** alguns segundos depois da confirmação, e não na hora exata do
> toque.

> **Assinatura no Stripe cobra sozinha**
>
> Quando um cliente assina um plano pagando com Stripe, quem faz a cobrança de todo mês é o
> próprio Stripe — não o aplicativo. Você vê os pagamentos normalmente na ficha do assinante, mas
> cancelar a assinatura precisa ser feito por aqui (nunca só pelo painel do Stripe), senão a
> cobrança continua.

## Conectar o Asaas (passo a passo)

O Asaas não usa o botão de redirecionamento. Você gera uma **chave de API** no painel do Asaas e cola no aplicativo. A linha do Asaas aparece no degrau **1 · A conta que recebe**, em **Configurações → Pagamentos** e também na página **Integrações** (que leva para esta mesma tela).

> **Precisa de um computador**
>
> A chave de API **não pode ser gerada pelo aplicativo do Asaas**. Faça esta etapa em um
> computador.

1. Em **Configurações → Pagamentos**, na linha do **Asaas**, toque em **Conectar**. Um formulário
   abre logo abaixo da linha.

2. Em um computador, acesse o painel do Asaas e vá em **Integrações → Chave de API**. Gere uma
   chave e dê o nome **"a plataforma"** (assim você sabe qual revogar depois).

3. Copie a chave inteira. Ela começa com **`$aact_`**. 👉 **Atenção:** não copie o **Wallet ID**
   (começa com `wal_`) — é outro código e não funciona aqui. A chave aparece **uma única vez**; se
   fechar a tela, é só gerar outra.

4. Volte ao aplicativo, cole a chave no campo e toque em **Validar e salvar**. Se a chave for
   válida, o Asaas fica **Conectado** na hora. Se for seu primeiro provedor, o pagamento online já
   é ativado automaticamente.

> **Produção ou teste (sandbox)?**
>
> Chaves de **produção** começam com `$aact_prod_` e recebem pagamentos reais. Chaves de
> **sandbox** começam com `$aact_hmlg_` e são só para teste — a linha mostra uma etiqueta
> **Sandbox** em amarelo e nenhum pagamento é real.

> **Conta nova ou sem liberação para o Pix Automático?**
>
> O Asaas libera o **Pix Automático** (a mensalidade debitada sozinha na conta do cliente) só para
> contas que atendem aos critérios dele — CNPJ ativo, tempo de cadastro, situação cadastral. Se a
> sua conta ainda não tem essa liberação, **a conexão funciona do mesmo jeito**: você conecta,
> recebe PIX e cartão normalmente, e continua sendo avisado de tudo (pagamento confirmado,
> vencido, estornado, contestado). O que fica de fora é só a cobrança recorrente por Pix
> Automático. Quando o Asaas liberar a sua conta, toque em **Trocar conta** e cole a chave
> novamente — é a reconexão que registra os avisos do Pix Automático. Só **Verificar conexão** (no
> menu **···** da linha) não basta: ele testa a chave, não refaz o registro.

> **Seus dados estão seguros**
>
> Guardamos sua chave **criptografada** e a usamos só para receber os pagamentos dos seus clientes
> na **sua própria conta Asaas** — não movemos seu dinheiro. Você pode **revogar a chave a
> qualquer momento** no Asaas (Integrações → Chave de API) e a conexão para na hora.

> **Chave parou de funcionar?**
>
> Se você revogar ou trocar a chave no Asaas, a linha fica em **Erro**. Abra o menu **···** da
> linha e toque em **Verificar conexão** a qualquer momento para testar a chave que está salva —
> se ela não estiver mais valendo, mostramos a mensagem do próprio provedor (ex.: "A chave de API
> fornecida é inválida") e a linha passa para **Erro**. Depois é só tocar em **Trocar conta** e
> colar uma chave nova para voltar a receber.

## Perguntas frequentes

**Como desconecto um provedor?**
Na mesma tela **Configurações → Pagamentos**, abra o menu **···** na linha da conta e toque em **Desconectar**. Lembre de ativar outra conta ou o recebimento online será desligado.

**Apareceu "não é possível desconectar" — e agora?**
Quer dizer que ainda existe cobrança viva naquele provedor: pagamento em andamento ou assinatura de cliente com cobrança automática. Cancele as assinaturas em **Assinaturas** (ou aguarde os pagamentos fecharem) e tente de novo. A recusa protege você: sem a conexão, a cobrança automática continua saindo da conta do cliente e ninguém consegue mais interrompê-la.

## Leia também

- [Como receber pagamentos online](https://docs.barbeiro.app/business-admin/settings/payments)
- [Cadastrar a maquininha e configurar as taxas do cartão](https://docs.barbeiro.app/business-admin/settings/payment-processors)
- [Pagamento antecipado, sinal e o que fazer numa falta](https://docs.barbeiro.app/business-admin/settings/payments-upfront)