Conectar o Mercado Pago, o Asaas ou o Stripe

Q: 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.

Quem aceita o quê

O Mercado Pago e o Asaas recebem Pix e cartão. O Stripe recebe só cartão, sem Pix. O dinheiro cai direto na sua conta do provedor; a plataforma não guarda nem repassa nada.

Conectar o Mercado Pago (passo a passo)

O Mercado Pago usa o botão Conectar normal: ele abre o site do Mercado Pago, você entra na conta que já usa e autoriza o recebimento. A linha do Mercado Pago 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).

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

Entre com a sua conta do Mercado Pago (ou crie uma) e autorize a plataforma a receber pagamentos em seu nome.

Ao voltar, aparece uma mensagem de sucesso e a linha mostra a etiqueta verde Recebendo, com o e-mail da conta e a data da conexão. Se for o seu primeiro provedor, o pagamento online já é ativado automaticamente.

Pix precisa de chave no Mercado Pago

Para o cliente pagar por Pix, a sua conta do Mercado Pago precisa ter uma chave Pix cadastrada. Se faltar, aparece o aviso Falta a chave Pix na sua conta do Mercado Pago: o cartão continua funcionando e o Pix some para o cliente até você cadastrar a chave no Mercado Pago e tocar em Conferir de novo.

Renovação automática no cartão

Com o Mercado Pago, o cliente que assina um plano pagando com cartão pela vitrine já fica com a cobrança mensal automática, igual ao Asaas. Quem entrou pelo balcão ou por PIX pode ligar a renovação automática depois, na página da assinatura.

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. O Stripe recebe só cartão: com ele, o Pix não aparece para o cliente. 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 a etiqueta verde Recebendo. Se o Stripe ainda pedir documentos da sua empresa, termine o cadastro no próprio site do Stripe: até lá ele pode recusar as cobranças.

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, a linha do Asaas mostra a etiqueta Recebendo 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 — o dinheiro não passa por nós. 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.

Atenção aos detalhes

Taxa da plataforma

Sobre cada pagamento online recebido pelo Mercado Pago, pelo Asaas ou pelo Stripe, a plataforma retém uma taxa de 2% do valor pago. Quem desconta é o próprio provedor, na hora do pagamento, junto com a taxa dele: na sua conta cai o valor já líquido. Pagamento no balcão não tem essa taxa.

Perguntas frequentes

Posso conectar o PagSeguro, a Iugu ou outro provedor? Hoje não. A tela mostra só as contas que você consegue conectar: Mercado Pago, Asaas e Stripe. Se o seu negócio cobra em euro, aparece só o Stripe.

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.