Pular para o conteúdo
IndicaSaaS
Navegar na documentação

Asaas

API-key · Pix, boleto e cartão

Conexão por API-key (sem OAuth). Pix, boleto e cartão. Cada SaaS recebe uma URL de webhook própria com um token.

Conectar

  1. No Asaas, gere sua API key (Integrações → API).
  2. No painel → Gateways → Asaas, cole a API key e clique Conectar. Após verificar a credencial e a identidade da conta, o painel devolve uma URL de webhook (https://indicasaas.com/webhooks/asaas/SEU_TOKEN) e um secret.
  3. No Asaas, em Notificações/Webhooks, cadastre essa URL, cole o secret e ative os eventos de pagamento.

Passe o ref no checkout

Leia a referência com AFS.getRef() e envie o valor completo, sem interpretar ou encurtar, no externalReference da cobrança/assinatura ao criar a cobrança. Se retornar null, omita o campo de indicação.

// Ao criar a cobrança/assinatura na API do Asaas:
{
  "customer": "cus_...",
  "billingType": "PIX",            // PIX | CREDIT_CARD | BOLETO
  "value": 49.0,
  "externalReference": ref          // AFS.getRef()
}

Eventos

EventoO que faz
PAYMENT_CONFIRMED / PAYMENT_RECEIVEDpagamento → conversão/comissão (dedup garante 1 só)
PAYMENT_REFUNDEDreembolso → clawback
PAYMENT_CHARGEBACK_REQUESTED / _DISPUTEchargeback → clawback
PAYMENT_AWAITING_CHARGEBACK_REVERSALvitória da disputa identificada → restauração da parcela debitada
SUBSCRIPTION_DELETED / _INACTIVATEDcancelamento