Conectar o Asaas
Receba em reais com cartão de crédito e PIX pela sua conta Asaas, com assinaturas, order bump e upsell de 1 clique.
O Asaas processa cartão de crédito e PIX em reais, para contas abertas no Brasil. Conectado ao Vipter, ele atende vendas avulsas, parcelamento no cartão, assinaturas, order bump e upsell de 1 clique. O boleto do Asaas não está disponível pelo Vipter.
Antes de começar
- Uma conta Asaas com usuário administrador: só ele vê o menu de integrações. Para experimentar antes, crie uma conta no Sandbox do Asaas. Sandbox e produção são contas separadas, com chaves e webhooks próprios.
- Papel Admin ou Dono no projeto do Vipter.
- Espaço no seu plano para mais uma conexão ativa. A tela de provedores mostra quantas você já usa.
Cartão salvo em produção depende do Asaas
Assinaturas e upsell de 1 clique cobram o cartão salvo do comprador. Em produção, isso só funciona depois que o gerente de conta do Asaas liberar a tokenização de cartão na sua conta. Peça a liberação antes de vender assinaturas.
Passo 1: gerar a chave de API no Asaas
- Entre no Asaas, no ambiente que você vai usar: o Sandbox para testar ou a conta de produção para vender.
- Abra IntegraçõesChave de API e gere uma chave nova.
- Copie a chave na hora: o Asaas só mostra o valor completo uma vez. A chave do Sandbox começa com
$aact_hmlg_e a de produção com$aact_prod_. Copie também o$do começo.
Guarde a chave com cuidado
A chave de API dá acesso à sua conta Asaas. Cole a chave só no Vipter. Se ela vazar, gere outra no Asaas e troque no Vipter pelo botão Trocar chaves.
Passo 2: criar a conexão no Vipter
- No painel do Vipter, abra PagamentosProvedoresAsaas.
- Clique em Nova conexão. Se a loja ainda não tem nenhuma conta Asaas, o formulário já aparece aberto.
- Preencha os campos numerados:
| # | Campo | O que colar |
|---|---|---|
| 1 | Nome da conta | Um nome para reconhecer a conta, como "Asaas Loja". Ele aparece nos fluxos de pagamento. |
| 2 | País da conta | Brasil, já selecionado. O Asaas só atende contas abertas no Brasil. |
| 3 | Chave de API | A chave que você copiou no passo 1, com o $ do começo. |
| 4 | Conexão de teste | Ligado para a chave do Sandbox ($aact_hmlg_). Desligado para a chave de produção ($aact_prod_). Uma chave de um ambiente com o botão no outro é recusada. |
- Clique em Salvar e obter a URL de webhook. O Vipter confere a chave com o Asaas antes de salvar. Se ela estiver errada, nada é gravado e o erro aparece no formulário.
O modo de teste vem ligado
O botão Conexão de teste começa ligado para que a primeira conexão não cobre ninguém por engano. Para vender, crie a conexão com ele desligado e a chave $aact_prod_.
Se a loja ainda não tem fluxo para cartão de crédito ou PIX, o Vipter cria esses fluxos apontando para a nova conta. A loja já pode cobrar depois do passo 4.
Passo 3: criar o webhook no Asaas
Pelo webhook, o Asaas avisa o Vipter do que acontece com cada cobrança: PIX pago, cartão aprovado, reembolsos e chargebacks. O Asaas não assina os avisos. Em vez disso, ele manda em cada aviso um token de autenticação que você define ao criar o webhook. Sem esse token salvo no Vipter, nenhum aviso é aceito, e a loja não fica sabendo quando um PIX é pago.
- Depois de salvar, o card da conexão mostra a URL do webhook. Copie o endereço.
- No Asaas, no mesmo ambiente da chave, abra IntegraçõesWebhooks e clique em Criar Webhook.
- Dê um nome, cole a URL copiada no item 1 e informe um e-mail para receber alertas do webhook.
- No campo do token de autenticação, clique em Gerar token ou escreva um valor de 32 a 255 caracteres, sem espaços. Não use a chave de API. Copie o token.
- Escolha o envio sequencial, para os avisos chegarem na ordem em que aconteceram.
- Marque os eventos de cobrança e salve o webhook.
- Volte ao Vipter, cole o mesmo token no card da conexão e clique em Salvar segredo.
| # | Campo | O que colar |
|---|---|---|
| 1 | Token do webhook | O mesmo token de autenticação do item 4, com 32 a 255 caracteres e sem espaços. |
Passo 4: testar a conexão
- No card da conexão, clique em Testar. O Vipter consulta o Asaas com a chave salva.
- Faça uma compra de teste no checkout de uma oferta, com a conexão do Sandbox:
- Cartão: no Sandbox, qualquer número de cartão fictício válido, com data futura e CVV de três dígitos, é aprovado. Os cartões
5184 0197 4037 3151(Mastercard) e4916 5613 5824 0741(Visa) simulam uma recusa. - PIX: a conta do Sandbox precisa ter uma chave PIX cadastrada. Gere o PIX no checkout e confirme o pagamento da cobrança pela interface do Sandbox do Asaas.
- Cartão: no Sandbox, qualquer número de cartão fictício válido, com data futura e CVV de três dígitos, é aprovado. Os cartões
Deu certo se
Aparece a mensagem Conexão OK., o card mostra Segredo de verificação configurado. e a compra de teste entra em VendasTransações como paga.
Problemas comuns
-
Seu plano permite N conector(es) ativo(s). Faça upgrade para adicionar mais.
O plano chegou ao limite de conexões ativas. Desative uma conexão que não usa mais ou mude de plano em Plano Vipter.
-
Valor inválido no campo da chave
A chave precisa começar com
$aact_. Copie de novo a chave inteira, com o$do começo. -
Valor inválido no campo do token
O token tem menos de 32 caracteres ou tem espaços. Use o token gerado pelo Asaas e salve o mesmo valor nos dois lados.
-
O Asaas recusou a chave
A chave é de outro ambiente: uma chave
$aact_hmlg_exige o botão Conexão de teste ligado, e uma$aact_prod_exige o botão desligado. A chave também pode ter sido apagada ou trocada no Asaas. -
Sem o segredo de verificação a plataforma recusa os eventos deste provedor. Cadastre a URL acima no provedor, copie o segredo e salve aqui.
O token do webhook não foi salvo no Vipter. Refaça o passo 3.
-
O PIX foi pago, mas o pedido segue pendente
O aviso do Asaas não chegou ou foi recusado. Confira se o webhook foi criado no mesmo ambiente da conexão, se a URL é a do card desta conexão e se o token no Asaas é igual ao salvo no Vipter.
O que fazer a seguir
- Defina quantas parcelas a loja oferece e com quais juros em parcelamento.
- Revise os fluxos de pagamento para decidir qual conta cobra cada pagamento e qual serve de reserva.