Administrador · Configurações
Conectar o Stripe ou o Asaas
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.
Em Configurações → Pagamentos, na linha do Stripe, toque em Conectar. Você é levado ao site do Stripe.
Entre na sua conta Stripe ou crie uma. O Stripe pede os dados da sua empresa e uma conta bancária para receber.
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.
Em Configurações → Pagamentos, na linha do Asaas, toque em Conectar. Um formulário abre logo abaixo da linha.
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).
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.
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
Ainda com dúvida?
Pergunte ao Barba sobre este tutorial. Ele responde com base nos nossos guias.
Este tutorial foi útil?