Integração com o Asaas
Com o Asaas conectado, a Filiafy:
- detecta pagamentos de clientes indicados, estornos, chargebacks e cancelamentos de assinatura;
- envia o Pix das comissões da sua própria conta Asaas, depois que você aprova o lote.
Conectar
- No Asaas, abra menu do usuário → Integrações → Chaves de API e gere uma chave. Nesta versão aceitamos chaves de sandbox (começam com
$aact_hmlg_). - Na Filiafy, em Integrações → Asaas → Conectar, cole a chave.
- Validamos a chave, registramos o webhook na sua conta e guardamos a chave criptografada. Ela nunca é mostrada de novo.
- Clique em Enviar evento de teste: o indicador fica verde quando o evento chega.
Eventos usados
| Evento do Asaas | O que acontece |
|---|---|
PAYMENT_CONFIRMED, PAYMENT_RECEIVED | Conversão criada e comissão lançada (se a regra pagar) |
PAYMENT_REFUNDED, PAYMENT_PARTIALLY_REFUNDED | Comissão estornada na proporção |
PAYMENT_CHARGEBACK_REQUESTED | Comissão estornada por inteiro |
SUBSCRIPTION_DELETED, SUBSCRIPTION_INACTIVATED | Indicação marcada como cancelada |
TRANSFER_* | Situação do Pix de cada afiliado |
Como reconhecemos o cliente indicado
Na ordem: o id do cliente no Asaas (quando já o conhecemos), o seu externalReference (o id do cliente no seu sistema, se você registrou o cadastro com externalId), o e-mail do cliente e, por fim, um código de indicação no externalReference da cobrança.
Pix para os afiliados
O lote só é enviado depois da sua aprovação, digitando o total. Recomendamos ativar a validação de saque via webhook no Asaas (Integrações → Mecanismos de segurança), com a URL e o token gerados na tela do lote. Assim o Asaas só libera transferências que são pagamentos aprovados na Filiafy, com o valor e a chave Pix exatos.
Ativar a validação bloqueia outras transferências feitas pela API do Asaas que não venham da Filiafy. Se você usa a API do Asaas para outras transferências, fale com a gente antes.