Metricaas + Asaas
Your MRR is rebuilt from scratch out of what Asaas records. Where it records everything, we measure. Where it does not, either the metric disappears from the screen or we make an assumption, and you have the right to read which one before trusting the number. This page is generated from the adapter's own capability sheet, so it cannot go stale.
What the gateway knows
Each row is a fact Asaas records, or does not. A "no" is never just a "no": it is a metric that changes.
| Product catalog | Product segmentation disappears for the whole account. The gateway has no products: a charge carries only a free-text description, and a filter covering half an account is worse than no filter at all, because it looks complete. | |
| Free trial | The gateway has no such concept. Giving 7 free days and issuing the first charge 7 days from now are the same operation to it. If you really do offer a free trial, declare it in Assumptions and we will read that gap as a trial. | |
| Free plan (freemium) | The gateway refuses charges below R$5.00. A user on your free plan has neither a subscription nor a charge there: they exist only in your own database. There is nothing to read, and we do not invent what was never recorded. | |
| Cancellation date | A deleted subscription does not say when it was deleted. Churn is dated at the end of the last paid period, which is the question the data can answer: not "when did they cancel?", but "how far had they paid?". | |
| Event history | There is no event history: a missed webhook is lost forever. That is why we sweep your account every night, and it is that sweep, not the webhook, that guarantees your number. | |
| Read-only key | The gateway has no read-only key. Every key it issues is full-access, which means the key you hand us can withdraw funds. We only use it to read, and to register our own webhook, but the risk is yours and you have the right to know before pasting it. Whitelist our IP in your account if you want to close that door. |
Assumptions and limits
None of this is optional to tell you. Every item below changes a number you are going to look at.
The gateway does not record: Asaas has no product catalog (a charge only carries a free-text description). Product segmentation is unavailable across the whole account while an Asaas source exists.
The gateway does not record: Asaas does not record trials. To it, "give 7 free days" and "issue the first charge 7 days from now" are the same operation, and no field tells them apart.
We assume: So trials only exist if you DECLARE that your business has them (in Assumptions). Without that, no customer is counted as a trial: it would be a guess, and a guess becomes a number on your screen.
The gateway does not record: A free plan cannot be represented: Asaas rejects charges below R$ 5.00. Your freemium users simply do not exist there.
We assume: Asaas does not store the cancellation date. We date churn at the END OF THE LAST PAID PERIOD, because the question it can answer is not "when did they cancel?" but "how long did they pay for?".
We assume: The biweekly cycle (BIWEEKLY) is treated as 14 days.
The gateway does not record: Asaas has no event history: you cannot list, replay, or audit past deliveries. A lost event is lost. That is why the reconciliation sweep always runs, not just when something fails.
The gateway does not record: Asaas does not notify us when a customer is created or updated. Name or email changes only show up on the next re-import (no impact on MRR).
We assume: A deleted customer disappears from Asaas listings. We recover them from the subscriptions and charges that reference them, so your history does not lose people.
Heads up: Asaas has NO read-only key: every API key is full access. The key you paste here can issue charges and transfer money. We only use it to read and to create the sync webhook, and our code blocks any other write.
Heads up: The Asaas API quota is YOURS (25,000 requests per 12h, shared with your own usage of the account). We keep a declared ceiling per sweep and stop at the first rate-limit refusal.
Why we ask
Your gateway cannot answer this. In it, giving 7 free days and issuing the first charge 7 days from now are exactly the same operation: no field tells the two apart. If we guessed from the gap between the subscription and its first charge, every subscription would become a trial (that gap always exists), and your funnel would show hundreds of trials that never happened. So we ask instead. Turn this on only if you really do give a free period before the first charge.
The switch lives in Settings, under Calculation Assumptions, and ships off. Turning it on recalculates your history right away.
Connect your Asaas account and see your MRR rebuilt. Free up to R$10,000 MRR.
Get started