Receber pelo Asaas: Pix e cartão com confirmação automática
Mis à jour le 1 octobre 2026
Conecte a sua conta Asaas com a chave de API e a sua página passa a cobrar pelo Pix ou cartão, com o horário confirmado sozinho quando o pagamento cai.
Com a sua conta Asaas conectada, quem marca pela sua página paga pelo Pix (o QR aparece na página do horário) ou pelo cartão (na página de pagamento do Asaas). O dinheiro cai na sua conta Asaas e o horário confirma sozinho quando o Asaas avisa: você não precisa conferir nada.
- No site do Asaas, abra Integrações e depois Chaves de API.
- Gere uma chave nova, dê o nome "Ruche" e copie. O Asaas mostra a chave uma vez só.
- No Ruche, em Ajustes, Pagamentos, toque em Conectar o Asaas.
- Cole a chave e toque em Conectar.
- Confira se a sua conta Asaas tem uma chave Pix ativa (no Asaas, em Pix, Minhas chaves; a aleatória serve). Sem ela, o Asaas não gera o QR do Pix e a sua página cobra só no cartão. Cadastrou depois? Toque em Conferir conexão no Ruche.
A partir daí, a sua página cobra pelo Asaas com as mesmas regras de sempre (sinal ou valor total, prazo para pagar, cancelamento). A primeira vez que alguém paga, a página pede o CPF ou o CNPJ de quem paga: o Asaas precisa dele para gerar a cobrança, e ele vai direto para o Asaas.
Devoluções
Quando um horário pago é cancelado, o Ruche pede a devolução ao Asaas sozinho, pelas suas regras, e o horário mostra Devolvendo pelo Asaas até o Asaas confirmar. No cartão, o Asaas só devolve o valor inteiro: se a sua regra manda ficar com o sinal, o horário pede a sua escolha, Devolver tudo pelo Asaas ou Devolvi por fora (você devolve a parte pelo Pix).
Autorizar a devolução do Pix no Asaas
O Asaas trata a devolução do Pix como uma ação que precisa da sua confirmação. Quando o Ruche pede uma devolução do Pix, ela fica parada no Asaas até você autorizar, e o horário mostra Falta autorizar a devolução no app do Asaas (você também recebe um e-mail).
- Abra o aplicativo ou o site do Asaas.
- Abra as transações que aguardam autorização.
- Confirme a devolução com o código que o Asaas manda por SMS ou pelo aplicativo.
Depois disso, o dinheiro volta para a pessoa e o Ruche marca como devolvido sozinho. Sem a autorização, a pessoa não recebe. Se a devolução for cancelada no Asaas, o horário volta a pedir a sua escolha: tentar de novo pelo Asaas ou devolver por fora. No cartão, a devolução sai sem essa etapa.
A chave e a conta de teste
A chave fica guardada cifrada e não aparece mais no painel. Chave que começa com $aact_hmlg_ é da conta de teste do Asaas: os pagamentos dela são de mentira. Para receber de verdade, use a chave da conta de produção ($aact_prod_).
Se algo parar
Em Ajustes, Pagamentos, toque na conta Asaas e em Conferir conexão: o Ruche confere a chave e religa os avisos de pagamento. Num horário, Consultar o Asaas lê a cobrança lá, se o aviso não chegou.
Cet article vous a-t-il aidé ?