Manage Subscription

Manage Subscription — simple guide for claimed shop owners

What this page is for Manage your shop’s recurring subscription(s) and review payment history. Use this page to check active plans, see when your plan expires (countdown), verify payment receipts (payment id / order id / license key), view recent billing history, and take immediate actions like contacting support or managing expenses if renewal is needed.

Top summary (what you see immediately)

  • Subscriptions list — each claimed listing row shows plan name, billing type, payment id / order id / license key, amount paid, status, and plan expiry (with a live countdown or “Plan Expired”).

  • Filters & sorting — filter by plan type, sort by claimed/created date or expiry.

  • Payment history — separate paginated list of recent PlanPaymentHistory records (payments, refunds, errors).

  • Quick actions — links to Manage Expenses, Employee Management and Sales Report for fast navigation.

Why it matters: keeps owner in control of their plan lifecycle — so you never get caught with an expired listing, unexpected downtime, or missing receipts.

Do this now: check your subscription card and confirm plan_expires_at countdown. If expiry is near, prepare to renew or update payment method.

How to use — step-by-step

  1. Open: Dashboard → Store Operations → Manage Subscription (for your claimed shop).

  2. Confirm ownership and active claim: the page is only visible if you’re the verified owner with an active, non-expired plan. If you see an authorization error, confirm you’re logged in with the claiming owner account.

  3. Scan the subscriptions list: for each subscription you’ll see:

    • Plan name (e.g., basic, pro)

    • Billing type (e.g., monthly, yearly, 30day)

    • Amount paid (converted from smallest unit like paise/cents → formatted currency)

    • Payment ID / Order ID / License Key (use these for reconciliation)

    • Plan expiry date and a countdown (e.g., 12 Days, 3 hours, 12 min and 20 seconds) or Plan Expired

    • Created/claimed date

  4. Filter / Sort: use the Plan filter to view specific plans, and sort by claimed_at, created_at, or plan_expires_at. Adjust per_page or paging to navigate large lists.

  5. Open payment histories: switch to the Payment History section to view recent payments, statuses, errors, order ids and receipts. Use this to verify transaction success or to locate failed payments.

  6. Check next billing date: billing types like monthly, yearly, 30day, 360day are interpreted to compute the “Next Billing Date.” If it shows N/A, billing type or creation date may be missing.

  7. Take action: if expiry is near or payment failed:

    • Contact your payment provider or the DialMyStore support team.

    • Locate the payment/order id or license key and provide it to support for faster resolution.

  8. Records for accounting: copy the displayed amounts, payment ids and dates into your bookkeeping or expense tracker.

What each field means (plain language)

  • Plan: the subscription tier assigned to your claimed listing (e.g., basic, business).

  • Billing Type: frequency or pattern for billing — examples:

    • monthly → next billing = claimed/created date + 1 month

    • yearly or 360day → next billing = +1 year

    • 30day, 60day, etc. → next billing = add that many days

    • Unknown/custom strings → treated as N/A for next billing date

  • Amount: payment amount shown in main currency (controller converts from smallest unit like paise/cents by dividing by 100).

  • Payment ID / Order ID / License Key: identifiers to reconcile payments with the payment gateway or internal records.

  • Status: subscription status (active / expired / cancelled / pending).

  • Plan Expires At: explicit expiry timestamp; if present a countdown will be shown until expiry.

  • Countdown: human-readable time left until expiration; if past, shows Plan Expired.

  • Created/Claimed At: when you claimed the listing or when the subscription was created.

  • Next Billing Date: computed from created/claimed date and billing type — useful to know when the next charge will occur.

Quick examples (common owner flows)

  • Check renewal window: Your plan_expires_at shows 6 Days, 12 hours... → contact finance or update payment method to avoid expiry.

  • Verify a payment: you see payment_id = pay_ABC123, amount = 499.00 and status = success in Payment History → save this as receipt proof.

  • Find failed payment: Payment history shows status = failed with error_message → contact support with the payment id and timestamp.

Tips & best practices for shop owners

  • Keep license keys and payment ids safe — copy them into your accounting records beside the invoice date. They speed up support and refund flows.

  • Check the countdown weekly — renew proactively to avoid downtime in your claimed listing.

  • Use filters (plan and sort) to find expired or near-expiry subscriptions fast.

  • If you have multiple claimed listings in the same place, confirm you’re viewing the correct row (shop name displayed).

  • Prefer descriptive billing types when subscribing (e.g., monthly) so the system computes the next billing date correctly.

Edge cases & validation (what can go wrong)

  • Unauthorized access / no active plan: if you’re not shown the page, either you’re not the verified owner or your plan expired / not active. Contact the person who claimed the shop or support to resolve ownership.

  • Missing payment record: sometimes ClaimedListing references a payment_id or license_key but the PlanPaymentHistory entry is not present — the controller falls back to the latest payment for the place/owner. If amounts mismatch, ask support to reconcile gateway logs.

  • Invalid expiry date: corrupted plan_expires_at will show Invalid expiry or N/A. Don’t rely on the countdown — verify expiry date with support.

  • Large page/result sets: pagination limits apply — adjust per_page to see more rows, or use export if available.

  • Timezones: timestamps are shown in server time; confirm timezone when reconciling with bank statements.

Troubleshooting (when things look wrong)

  • Plan shows “Plan Expired” but you paid recently:

    • Check Payment History for the payment status and timestamp.

    • If payment status is success but subscription not updated, provide payment_id / order_id to support for manual reconciliation.

  • Next Billing Date shows N/A:

    • Billing type or created/claimed date may be missing or malformed. Contact support with your claimed listing details.

  • Amounts don’t match your bank statement:

    • Amounts displayed are converted from the smallest unit (e.g., paise → divide by 100). Confirm currency and minor unit assumptions with your finance team.

  • I don’t see subscription page at all:

    • You must be logged in as the claimed listing owner and the claimed listing must be active and not expired. If ownership changed, contact DialMyStore support.

  • Payment marked failed with an error_message:

    • Use the displayed error_message (if any) and the payment_id when contacting the payment gateway or DialMyStore support to retry or re-process.

Security & privacy note (short)

Only the claimed listing owner (authenticated user) can access this page for a given place_id. Payment history contains sensitive info (payment ids, license keys) — treat these like receipts and don’t share publicly.

Action plan — what to do in the next 10 / 30 minutes

10-minute check

  1. Open Manage Subscription and find your primary subscription row.

  2. Note plan_expires_at and countdown. If expiry < 7 days → prepare renewal.

30-minute reconciliation

  1. Open Payment History and match the last 2 payments against bank statements.

  2. Save payment ids and order ids in your records for audit.

FAQ (common owner questions)

Q: Who can see and manage subscriptions? A: Only the authenticated owner of the claimed listing with an active plan that has a future expiry date.

Q: What does billing type 30day mean? A: It means the next billing date is calculated by adding 30 days to the created/claimed date. The system also understands monthly, yearly, 360day, and other \d+day formats.

Q: Why does the page show a fallback payment record? A: If a ClaimedListing’s payment_id or license_key doesn’t match any recent PlanPaymentHistory record, the system falls back to the latest payment for that shop+owner to provide a best-guess display.

Q: Amounts look small (e.g., 499 instead of 49900)? A: The backend stores amounts in the smallest currency unit (paise / cents). The UI divides by 100 to show the main currency. If you suspect a mismatch, verify with the raw PlanPaymentHistory record.

Q: My plan expired but I still see the page — is my listing live? A: If plan_expires_at is past, the row may still show but the countdown will read Plan Expired. Some features may be disabled for expired plans — verify the listing’s public visibility.

PreviousProfit/Loss ReportNextTax

Last updated