Public MRR e Trust MRR

​

Quando usar

​

Como funciona

• O token mrr_ é só de leitura. Ele vai no header Authorization: Bearer mrr_... e não altera nada na sua conta.
• O token só vale nas rotas de Public MRR. Em qualquer outra rota, a API responde 401 Unauthorized. As rotas de Public MRR também não aceitam a chave de API: com ela, a resposta é o mesmo 401.
• Os dados são sempre de produção, mesmo que o token tenha sido gerado com o Modo Teste ligado.
• O token não muda depois de gerado.
• As rotas existem na v1 e na v2. Use a v2: https://api.abacatepay.com/v2/public-mrr/....
• Os valores são em centavos (129900 = R$ 1.299,00).

​

Como o MRR é calculado

• O MRR soma as assinaturas ativas que já pagam, cada uma com o valor de um mês: a anual conta 1/12, a semestral 1/6, a trimestral 1/3, e assim por diante.
• A assinatura em período de teste (trial) conta em totalActiveSubscriptions, mas ainda não conta no MRR. Ela entra no MRR quando o trial acaba.
• A assinatura cancelada sai das duas contas na data do cancelamento.
• O MRR por dia é o MRR no fim de cada dia, no horário de Brasília, com até 366 dias por consulta.
• A receita por período soma as vendas de cada dia, no horário de Brasília: o total em totalRevenue, a quantidade em totalTransactions e o detalhe por dia em transactionsPerDay. O período precisa ter pelo menos dois dias: com startDate igual a endDate, a API responde End date must be after start date.

​

Como gerar o token no dashboard

​

Pela API

curl https://api.abacatepay.com/v2/public-mrr/mrr \
  -H "Authorization: Bearer mrr_SEU_TOKEN"

{
  "data": {
    "mrr": { "currency": "BRL", "value": 129900 },
    "totalActiveSubscriptions": { "currency": "BRL", "value": 12 }
  },
  "success": true,
  "error": null
}

​

Perguntas frequentes