Skip to main content

Subscription & Billing

Your church's plan is managed in Settings → Subscription Plans. The screen shows your current plan at the top and the plans you can move to below it.

Pricing note: plans, features, and prices come from the Nlarj backend and can change. The exact numbers for your region are shown inside the app — the plan cards display the live monthly price and currency symbol fetched from the server. For anything not visible there, contact us at billing@nlarj.app for pricing.

Current plan card​

The gold card at the top of the screen shows:

  • Plan name — the friendly name of your current plan
  • Status — Active, Past Due, or similar
  • Expires on — the next renewal date, if applicable

Available plans​

Below the current plan card, the app shows the plans you can move to. What you see depends on your current status:

  • Active subscription — only strictly higher-tier plans are offered (no downgrades)
  • Past due — every plan is offered, including your current one (for renewal) and lower tiers (to step down)
  • No active subscription — the full list of plans is shown so you can pick one

Each plan card shows:

  • Plan name and price per month, in your region's currency
  • Maximum members included
  • Global events per month (if the plan supports them)
  • Additional features as a list of chips

The plan marked POPULAR is an enterprise-tier plan highlighted by the backend. The plan marked YOUR CURRENT PLAN is the one you're on today (visible when you're in the renewal flow). The LOWER TIER label marks plans below your current tier.

Upgrade, renew, or switch​

Tap a plan card's button to start a purchase. The button's label depends on context:

  • Upgrade to [Plan] — you're moving up from your current plan
  • Renew [Plan] — your subscription is past due and you're paying for the same plan again
  • Switch to [Plan] — you're moving to a lower tier (only allowed when past due / expired)
  • Current plan — disabled; nothing to do

The backend decides whether a given purchase counts as an upgrade, renewal, or fresh start — the mobile app does not compute prices or set amounts locally.

Billing information​

Before payment you're asked for:

  • Billing Email — required, used for the invoice
  • Phone Number — optional
  • Billing Address — optional

These details are remembered on your subscription so you don't retype them next time.

Payment​

Paid plans are processed through Razorpay. The app opens the Razorpay checkout with the amount and currency the server returns (never a locally-computed amount). Inside Razorpay, your members can pay via card, UPI, net banking, or wallets — whatever Razorpay supports in your region.

If you pick a free plan, there's no checkout — the plan is activated immediately and you see a confirmation dialog.

Renewal and grace period​

If your plan expires and isn't renewed, the app shows a warning banner at the top of the Subscription screen. It displays:

  • The plan that lapsed
  • The date it ended
  • How many days of grace access remain
  • A Renew button that creates a new order for the same plan at the live backend price

After the grace period ends, the church is automatically downgraded to the free tier and paid features stop working. The grace-period length comes from the backend (default is 7 days, but contact support to confirm for your region).

After a successful payment​

On success, the app:

  1. Records the payment
  2. Invalidates cached subscription data
  3. Shows an Upgrade Complete! dialog
  4. Refreshes the current-plan card with the new plan details

If verification fails on the server (rare — usually a transient network issue), the app surfaces the error and keeps the old plan intact.

Errors you might see​

  • "Please wait X seconds before trying again" — rate-limited. Try again after the wait.
  • "Your subscription is already active — no action needed" — race condition, usually caused by a webhook arriving from a different device. The banner clears on refresh.
  • "You can switch to a lower plan when your current subscription renewal is due" — downgrades are only allowed when the plan is past due or expired, not while active.
  • "This plan is not available. Please contact support." — the backend rejected the plan code. Reach out and we'll sort it.
  • "Plan service is temporarily unavailable." — transient server issue; retry in a minute.
  • Payment errors — network issues, card declines, and invalid options are surfaced with provider-side messages. Cancelling the Razorpay sheet is silent (no error).

Payment history​

Settings → Subscription History shows every subscription-related transaction for your church:

  • Plan name
  • Description (e.g. "Membership Purchase")
  • Status (Completed, Pending, Failed, Cancelled, Refunded)
  • Amount with currency symbol (₹, $, €, or £)
  • Date
  • Payment method
  • Transaction ID

Use the year and month selectors at the top to filter. Tap Need Help? on any row to open a pre-filled support ticket that includes the transaction ID, amount, status, and plan.

Contact billing​

For anything not handled in-app — invoices, PO numbers, non-profit discount eligibility, enterprise contracts, regional pricing, or anything else — email billing@nlarj.app or open a support ticket from inside the app.