Asaas: cobranças e PIX

Como a Zariv usa a conta Asaas da imobiliária para cobrar, dar baixa automática nos pagamentos e fazer repasses por PIX.

O Asaas é a instituição de pagamento que emite os boletos e PIX, e que envia os PIX de repasse. Cada imobiliária usa a própria conta. A Zariv conecta com a chave de API dessa conta e cuida do resto: emitir, acompanhar, dar baixa e registrar.

#O que a integração faz

1. CobrarA Zariv pede ao Asaas um boleto, um PIX ou os dois e envia o link ao cliente.
2. Receber o aviso de pagamentoQuando o cliente paga, o Asaas chama a Zariv (webhook). A fatura é baixada, o caixa é lançado e o comprovante sai por WhatsApp.
3. RepassarA Zariv pede ao Asaas um PIX ao proprietário. O Asaas confirma com a Zariv antes de soltar o dinheiro.

#Configurar

1. Gere a chave de API no Asaas
   Na sua conta Asaas, em Integrações, crie a chave de API. Para repasses, ela precisa de permissão para transferências.
2. Escolha o ambiente
   Comece no sandbox (testes). Só depois use produção.
3. Cadastre na Zariv
   Em Configurações›Financeiro & Asaas, informe a chave e o ambiente e salve.
4. Deixe o webhook de pagamentos ativo
   A Zariv registra no Asaas o endereço que recebe os avisos de pagamento. Se ele parar de chegar, o Log do Sistema mostra.
5. Conferir o saldo
   O saldo da conta aparece no dashboard do financeiro, o que confirma que a chave está certa.

#Webhook de pagamentos

É o aviso que o Asaas manda à Zariv quando uma cobrança muda de estado (paga, estornada, vencida). Sem ele, o sistema não sabe que o cliente pagou. A Zariv:

• confere um token secreto em cada aviso e rejeita o que não vier do Asaas;
• trata cada aviso uma só vez, mesmo que o Asaas reenvie;
• mostra no Log do Sistema (categoria “webhook de pagamento”) cada aviso recebido e o que foi feito com ele;
• vigia o webhook e alerta quando ele para de chegar.

#Validação de saque por webhook

Esta é a parte que libera o repasse por PIX. Por segurança, o Asaas não solta uma transferência pedida por API sem uma confirmação. Com a validação por webhook, essa confirmação é automática: o Asaas pergunta à Zariv “posso liberar este PIX?”, e a Zariv responde sim apenas se foi ela mesma que pediu, com o mesmo valor e a mesma chave.

1. Abra os mecanismos de segurança
   No Asaas, menu do usuário › Integrações › Mecanismos de segurança.
2. Habilite a validação de saque via webhook
   Informe o endereço de validação e o token que a Zariv mostra em Financeiro›Aprovações de pagamento, e um e-mail para avisos de erro.
3. Não marque as opções adicionais
   Deixe desmarcadas as caixas extras (aprovação por SMS ou aplicativo). Elas travariam os repasses automáticos.
4. Teste com um valor pequeno
   Faça um repasse de teste e confirme que ele conclui sem pedir código.

#Custos

As tarifas de boleto, PIX e transferência são as do contrato da imobiliária com o Asaas, descontadas na conta Asaas dela. A Zariv mostra a tarifa de transferência, quando há, no recibo do repasse.

#Resolução de problemas