Subscription Details — Help & User Guide

Page: Subscriptions/ViewSubscription.aspx

Purpose

• Displays details for a single subscription.
• Lets users view license usage, top-up credits, edit package/storage/licenses, control auto-renewal, renew now, and cancel a subscription.

Culture: en-GB (dates formatted dd/MM/yyyy).

Quick start (end user)

• View subscription: open the subscription from the list — page shows subscription number, business, app, dates, fees and status.
• Top-up credits: choose an amount from ddlTopupAmount and click ButtonPayTopUp → takes you to payment flow.
• Edit package/storage/licenses: click LinkButtonEditSubPackage, LinkButtonEditStorage, or LinkButtonEditNoOfLicense.
• Renew now: click LinkButtonRenewNow.
• Auto Renewal: click LinkButtonEditAutoRenewal — a modal explains policy and lets you turn auto-renewal On/Off (if payment method exists).
• Cancel subscription: click ButtonCancel (opens confirmation modal) → enter password and confirm to cancel.
• View license users: dgSubscriptionUser lists assigned users and roles.

Primary page areas and controls

Header

• Page title: Subscription Details

Alerts

• ErrorPanel + LabelErrorMessage — shows errors; close with X button which runs clearError().

Credit / Top-up

• LabelAvailableCredit, LabelCreditExpiry
• ddlTopupAmount, ButtonPayTopUp
• LinkButtonUsageHistory opens usage history

Subscription details

• Key labels include:
• lblNumber, lblEntityName, lblAppName, lblSubscription
• lblStartDate, lblEndDate
• lblSubFeeNet, lblSubFeeTax, lblSubFeeGross
• lblNextRenewalDate, lblAutoRenewal, lblSubStatus
• Action links:
• LinkButtonEditSubPackage
• LinkButtonEditStorage
• LinkButtonEditNoOfLicense
• LinkButtonRenewNow

License in use

• Grid dgSubscriptionUser — columns include USERDETAILS, USERROLENAME
• Sorting: dgSubscriptionUser_Sorting
• Row formatting: dgSubscriptionUser_RowCreated

Cancel subscription slide-panel

• slidePanel shows cancellation text and warnings, password input (TextBoxPassword), confirm (btnCancel) and cancel (btnClear)
• JavaScript helper: openCancelSubscriptionModal() builds the confirmation modal and forwards password into TextBoxPassword

Auto-renewal slide-panel

• slidePanelAutoRenewal contains:
• DivAutoRenewalOn (radio buttons RadioButtonRenwalOn / RadioButtonRenwalOff)
• DivAutoRenewalOff (message shown if no saved payment method)
• HiddenAutoRenewalValue holds the chosen value; update triggered by ButtonUpdateAutoRewal (ButtonUpdateAutoRewal_Click)
• JavaScript helper: openAutoRenewalModal() shows the modal with policy text and handles the “no payment method” case

Reusable confirmation modal

• ConfirmaitonMessage1Card + ConfirmaitonMessage1Overlay expose:
• openConfirmaitonMessage1(options)
• closeConfirmaitonMessage1()
• Toast notifications:
• updateToast element with showUpdateToast(message, ms) for brief messages

Client-side behaviors & keyboard accessibility

• Escape closes slide panels and confirmation modal
• Confirmation modal:
• Click overlay or X to close
• Confirm button triggers the configured action
• Toasts announce via aria-live="polite"
• clearError() supports jQuery fadeOut where jQuery exists; otherwise hides via DOM
• Cancellation password is copied from the modal into server TextBoxPassword before triggering server postback

Key actions (user guide)

Top-up credits

1. Choose an amount in ddlTopupAmount
2. Click ButtonPayTopUp
3. Complete payment flow
4. Return to this page to confirm updated credit

Edit package/storage/licenses

• Click:
• Edit Package → changes plan
• Edit Storage → buys additional storage
• Edit Licenses → changes seat count
• Review prorated totals and click Save on the relevant edit page

Renew now

• Click Renew Now
• Review totals and proceed to payment

Auto-renewal

• Click Auto Renewal
• Choose On/Off in the modal (if payment method exists)
• Click confirm to save

Cancel subscription

• Click Cancel
• Read warning text
• Enter password and confirm
• Wait for success/error message

Security & data validation (important)

• Password entry for cancel should always be validated server-side inside btnCancel_Click.
• All inputs used to build SQL must be parameterized (do not append raw values into SQL).
• Use server-side authorization checks: validate current user has rights to view/update the subscription before performing actions.

Troubleshooting checklist

• Modal does not show / overlay remains hidden:
• Verify client IDs at runtime (scripts use <%= control.ClientID %>)
• Check for JS errors in browser console
• Password not passed to server:
• Confirm openCancelSubscriptionModal() sets TextBoxPassword before clicking btnCancel
• Auto-renewal changes not persisted:
• Confirm HiddenAutoRenewalValue receives value before ButtonUpdateAutoRewal click
• Toast not appearing:
• Ensure updateToast exists and showUpdateToast is called (check z-index)
• Grid user list empty:
• Check data-binding in code-behind and confirm grid binds on correct lifecycle events

When to contact support

Provide:

• subscription number
• business name
• screenshots of errors
• the action you attempted (top-up / renew / cancel / auto-renewal change)
• approximate time of action and browser used