Overview
EuroMail billing runs on subscription plans. Each plan grants a monthly sending quota and a set of features; you manage payment through Stripe-hosted pages, so EuroMail never touches your card details. For current plan tiers and pricing, see the pricing page.
For the full endpoint reference, see the Billing API reference.
Seeing the available plans
curl https://api.euromail.dev/v1/billing/plans \
-H "X-EuroMail-Api-Key: em_live_your_key_here"Each plan lists its price, monthly email quota, and included features.
Subscribing and changing plans
Subscriptions are handled through Stripe Checkout. Start a checkout session and redirect the user to the returned URL:
curl -X POST https://api.euromail.dev/v1/billing/checkout \
-H "X-EuroMail-Api-Key: em_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{ "plan": "..." }'After payment, Stripe notifies EuroMail and your plan activates automatically. Most teams simply use the Billing page in the dashboard, which wraps the same flow.
Managing an existing subscription
To update a card, change plan, download invoices, or cancel, open the Stripe customer portal:
curl -X POST https://api.euromail.dev/v1/billing/portal \
-H "X-EuroMail-Api-Key: em_live_your_key_here"The response contains a portal URL to redirect the customer to. Check the current subscription state programmatically:
curl https://api.euromail.dev/v1/billing/subscription \
-H "X-EuroMail-Api-Key: em_live_your_key_here"Quotas, overages, and what happens at the limit
Your plan sets a monthly email quota. EuroMail counts sends against it in real time, with the counter reconciled against the database so it stays accurate even across retries and restarts. As you approach the limit you are warned. What happens when you reach it depends on your plan:
- Free plan -- hard cap. Once the monthly quota is exhausted, further sends are rejected (HTTP 429) until the next cycle or a plan upgrade.
- Paid plans -- overage allowed. Reaching your quota never cuts off sending mid-month. Volume beyond your quota is metered and billed as overage per additional 1,000 emails on your next invoice (Stripe metered usage), so a seasonal spike never blocks your mail. (Sending can still be paused independently if an account trips abuse protection.) For your plan's overage rate, see the pricing page or contact [email protected].
This makes paid plans a good fit for seasonal or spiky volume: size your plan for your typical month rather than your peak, and let overage absorb the busy months instead of paying for a larger plan year-round. Track usage on the dashboard either way.
Transactional vs. marketing volume. Both count toward your quota. If you run large newsletter broadcasts, size your plan for the combined peak, not the average.
Sub-accounts and consolidated billing
If you resell or separate workloads with sub-accounts, billing rolls up to the parent account. Each sub-account's usage is attributed separately for reporting while a single subscription covers them.
Data residency note
Billing metadata is processed through Stripe; all of your email content, logs, and analytics remain on EU infrastructure in Finland. See EU Data Residency.