1What FoxPlug reads from Dodo Payments
These are the exact things it reads, and nothing else.
| What | The details it takes |
|---|---|
| Subscriptions | up to 5 pages of 100 subscriptions from the live Dodo Payments address, stopping early when a page comes back short. Per subscription: status, price, quantity, currency, billing interval and count, created time and cancelled time. |
| Monthly amount per subscription | the price before tax, times the quantity, turned into a monthly figure from the billing interval (year, week, day or month) and its count. Discounts are not applied. |
| Active subscribers and monthly revenue | subscriptions with status active are counted, and each adds its monthly amount. |
| Past-due subscriptions | status past due or on hold: how many, and the monthly amount at risk. The count is stored only when it is above zero. |
| New and cancelled in 30 days | new = created in the last 30 days, leaving out pending, failed and expired; cancelled = status cancelled with a cancelled time in the last 30 days. |
| Currency | the currency on the subscriptions as read (the last one seen wins), in lower case; usd when none is given. |
2Moments it finds, and what each becomes
A moment is one thing that happened in Dodo Payments worth a second look. Each one is scored, then it becomes a post, a changelog entry, a thing to fix or an idea to email, or it is skipped.
The first active subscription is read
The moment is titled like this: 💸 Got the first paying customer
A maker connects Dodo Payments and presses Check for what's new. One subscription is active, so the moment reads 'Got the first paying customer' with the line 'Someone is paying for the thing I'm building (counted from Dodo Payments).' A post is drafted for review.
Active subscriptions reach 10, 50 or 100
The moment is titled like this: Passed 10 paying subscribers
The 10th active subscription is read. The moment 'Passed 10 paying subscribers' is written once, described as '10 people now pay for it every month (counted from Dodo Payments).'
One or more subscriptions are past due
The moment is titled like this: No milestone. Brief line like '2 subscriptions are past due, $48 a month at risk.'
Two subscriptions show past due. The monthly amount at risk is added up from their prices and the brief puts a Fix line ahead of any post.
Monthly revenue crosses a milestone number between two reads
The moment is titled like this: Brief line: 'You passed $500 a month. Tell people.'
A first read shows $480 a month and a later read at least a day on shows $520. The brief offers a Say line for crossing $500.
3How the brain uses it
The rules below are the ones that apply to Dodo Payments. The same rules, with worked examples, are on the brain page.
- Dodo Payments reports past-due subscriptions, which become the fix line. How the brain decides
- The first paying customer, then 10, 50 and 100 subscribers, become say lines. How the brain decides
- Crossing a monthly revenue milestone ($100 up to $50,000) becomes a Say line. How the brain decides
- Card expiry, saving customers and win-back need each customer's details, so they stay Stripe only. How the brain decides
- When several revenue tools are connected the brief uses one: connected Stripe first, else another connected one. How the brain decides
4Set up Dodo Payments in a few steps
Access: Live API key pasted into FoxPlug. What to give it: Live API key. Dodo Payments lets each key be set to None, Read or Write per area, so the guide says to give Subscriptions Read and everything else None. Test keys (starting dodo test) are refused.
- In Dodo Payments, switch to Live mode, open Developer, then API Keys, and choose Create New Key named FoxPlug.
- Set Subscriptions to Read and leave every other row on None.
- Copy the key right away, because Dodo Payments shows it only once, and paste it into the Dodo Payments box in FoxPlug.
5Limits worth knowing
Where it stops, so nothing surprises you.
- At most 500 subscriptions are read (5 pages of 100); if the last page is full the result is marked partial.
- MRR is list price before tax and before discounts, so a discounted subscription is counted at full price.
- Trial subscriptions show as active in Dodo Payments and are counted and priced as active; the trial price is not looked at.
- On hold is counted as past due; Dodo Payments' own wording for that status was not checked beyond its name.
- If subscriptions use more than one currency, the last currency seen is reported for the whole total and amounts are not converted.
- The brief shows one revenue tool at a time, so with Stripe connected as well, these numbers are not the ones shown.
- No failed-payment rescue, expiring card, saving or win-back drafts: those are Stripe only.
6What it never reads
Read only means read only, and the list below is what the code leaves alone.
- Customer names, emails, addresses and cards. The customer and billing parts of each subscription are never touched.
- Discounts, tax, add-ons and usage meters: only the pre-tax list price is used.
- Anything written back: only plain GET reads of the subscription list.
- Test mode data: a test key is refused and only the live address is called.
7How Dodo Payments differs from the tools next to it
Dodo Payments lists subscriptions page by page with the price and billing interval on each one, so no second price lookup is needed, unlike Lemon Squeezy. Its key can be limited to Read on Subscriptions, which Polar's documentation does not list. Past due and on hold both count as at risk.
8Questions
Does FoxPlug see my customers' names or emails from Dodo Payments?
No. It reads subscription status, price, currency, billing interval and dates. No customer detail is read or stored.
Which key does it need?
A live API key with Read on Subscriptions and nothing else. Dodo Payments lets you set each area to None, Read or Write when you make the key.
Can I use a test key?
No. A test key holds test data, so FoxPlug refuses it and asks for a live key.
When does it read Dodo Payments?
When you press Check for what's new or Build the brief.
FoxPlug reads this tool only when you press Check for what's new, and only to read. Plans and limits are on the pricing page. Questions: support.