Alunta

The Alunta integration connects your Alunta subscription management system to GrowPanel via OAuth. There are no API keys to copy and no webhooks to configure manually — you click Connect, approve the read-only permissions in Alunta, and GrowPanel starts importing your data immediately.

This guide covers the setup, what GrowPanel imports, and what to expect in your reports after connecting.

Before you begin

To integrate Alunta with GrowPanel you need:

• Access to your Alunta team
• Permission to authorize OAuth apps for the team

You do not need to find or manage API keys. The entire setup uses OAuth.

Step 1: Start a new Alunta data source in GrowPanel

From inside GrowPanel, go to Settings → Sources → Add data source, click Other billing sources, and choose Alunta.

Give the data source a descriptive name — for example "Alunta Production" or "Alunta - Main team" — and click Next.

Step 2: Approve the Alunta OAuth permissions

After clicking Connect, you will be redirected to Alunta. Alunta shows an OAuth consent screen explaining exactly which permissions GrowPanel needs:

• Read customers
• Read subscriptions
• Read invoices
• Read plans

All permissions are read-only. GrowPanel cannot modify customers, change subscriptions, charge cards, or create invoices in your Alunta account. It can only read existing data.

Select the team you wish to connect (if you have access to several) and approve. Alunta then redirects you back to GrowPanel, where the import begins automatically.

Step 3: GrowPanel imports your data

You will see a progress screen showing the initial import. GrowPanel first discovers all your customers in Alunta, then processes each one to build the full billing history. Depending on the size of your account, this takes from a few seconds to about an hour.

The import runs in the background — you can navigate elsewhere in GrowPanel or close your browser. You will receive an email once the import is complete.

Step 4: Real-time sync via webhooks

After the initial import, GrowPanel listens to Alunta webhooks for ongoing changes. New subscriptions, cancellations, plan changes, payment events, and invoices flow into GrowPanel within seconds — no manual setup needed on your side.

What GrowPanel imports from Alunta

GrowPanel builds a complete view of your subscription business from Alunta data.

Customers

• All active, cancelled, and trialing customers
• Contact information, country, currency
• Billing relationships (which subscriptions belong to whom)
• Current MRR per currency for verification against Alunta's own numbers

Subscriptions

• Status (active, cancelled, scheduled cancellation, paused)
• Start date, end date, end reason (Cancelled, Expired, Suspended)
• Trial start and end dates
• Pricing model (flat rate, per-unit, license-based, tiered, usage-based)
• Discounts attached to subscriptions, including percent-off and fixed-amount

Invoices

• All invoices with their full line items
• Period covered by each line (start and end date)
• Plan and subscription each line belongs to
• Proration lines for mid-period changes
• Credit notes and refund handling

Plans and pricing

• All plans, including their full renewal-interval catalog
• Prices per currency and per billing interval (monthly, yearly, etc.)
• Plans with multiple intervals (e.g. monthly and annual versions) are automatically grouped together so they appear as a single product in your reports.

MRR movements

GrowPanel calculates the standard MRR movement types from your Alunta data: new, expansion, contraction, reactivation, and churn. Plan changes, which Alunta records as a cancellation followed by a new subscription, are automatically merged into a single "plan change" movement so your churn numbers stay accurate.

Cashflow data

For teams using Alunta's online payment options (card payments via Stripe, OnPay or QuickPay), GrowPanel imports payment dates and amounts and uses them to populate the cashflow report — showing when payments came in and how much.

For teams that handle payments outside Alunta (e.g. bank transfer without registering it in Alunta), the cashflow report will be empty since GrowPanel cannot infer that an invoice was paid. All other reports work fully regardless.

Some payment-related features rely on data Alunta does not currently expose, and are therefore not available for Alunta data sources, regardless of payment method:

• Failed payment tracking and recovery rate
• Payment method breakdown (card brand, card last 4 digits, payment type)
• Detailed refund history (refunds are reflected in MRR and net revenue, but without a separate refund timeline)

What to expect after import

Dashboard and key metrics

• MRR, ARR, ARPA, LTV across all currencies
• New / expansion / contraction / reactivation / churn movements
• Customer counts, churn rate, net revenue retention

Customer analytics

• Full list of imported customers with their subscription history
• Per-customer MRR over time
• Cohort analysis grouped by signup month

Plans and subscriptions

• Plan-level performance with monthly and yearly variants grouped together
• Subscription lifecycle events including discount tracking

MRR movements table

• Detailed log of every MRR-adjusting event
• Filterable by movement type, plan, currency, country, or any custom segment

AI-powered email reports

• Daily morning summary of what changed in your business
• Highlights large new accounts, at-risk subscriptions, and unusual patterns

Best practices

One Alunta team per data source. Each OAuth connection is scoped to a single Alunta team. If you operate multiple teams, add them as separate data sources in GrowPanel.

Reconnect if needed. Access tokens are long-lived and refresh automatically in the background. If you ever revoke GrowPanel's access in Alunta, just click Reconnect in GrowPanel to re-authorize.

Combine with other sources. If part of your business runs through Stripe, Chargebee, or Recurly in addition to Alunta, connect all of them. GrowPanel merges the metrics across sources and gives you a single, unified view of your business.

Common questions

Why do I see multiple plan rows for the same Alunta plan?

Alunta supports multiple renewal intervals (monthly, yearly) and multiple currencies for the same plan. GrowPanel imports each interval-currency combination as a separate row internally for accurate MRR calculation, but groups them under one plan group, so reports show your plan as a single unit.

Will plan changes appear correctly?

Yes. Alunta records plan changes as a cancellation followed by a new subscription. GrowPanel automatically detects this pattern and merges the two events into a single "plan change" movement, so your churn and expansion numbers stay accurate.

Will cashflow reports work?

Yes — but only for teams using Alunta's online payment options (Stripe, OnPay, QuickPay). When payments are registered in Alunta, GrowPanel imports the payment date and amount, so the cashflow report shows when money came in. For teams that handle payments outside Alunta (e.g. bank transfers without manual registration), the cashflow report will be empty because GrowPanel cannot infer that an invoice was actually paid.

Why don't I see failed payment tracking or payment method breakdowns?

These features require data Alunta does not currently expose to integrators (failed-attempt history, card brand, card last-4, etc.). They are therefore not available for Alunta data sources. All other reports — MRR, churn, cohorts, expansion, retention, basic cashflow — are unaffected.

Can I export data from GrowPanel back to Alunta?

Not at this time. The integration is read-only by design — GrowPanel never modifies your Alunta data.

Summary

Connecting Alunta to GrowPanel takes a few clicks and gives you deep analytics on top of your billing data: MRR trends, churn analysis, cohort retention, AI-powered insights, and more. The integration is read-only via OAuth and syncs in real time via webhooks.

If you run into issues, contact our support team — we're happy to help.