Subscription Status & Credit Management

This guide explains how administrators can review subscription status, manage user credit balances, sync local subscription records with Stripe, and open the related Stripe subscription from the WordPress admin.

Subscription List Columns

ColumnMeaning
UserThe WordPress user display name or login associated with the subscription.
EmailThe user’s WordPress account email address.
PlanThe current local SeaAI subscription package. When available, the monthly credit allowance is shown below the plan name.
StatusThe local subscription status, usually synced from Stripe. Common values include Active, Trialing, Past Due, Cancelled, Expired, and Paused.
CreditsThe user’s current total SeaAI credit balance in WordPress.
Started AtThe current subscription period start time. If that is unavailable, the local subscription creation time is shown.
Next RenewalThe current subscription period end time. For active subscriptions, this is the expected next renewal date.
Stripe Subscription IDThe Stripe subscription identifier, such as sub_xxx. This links the WordPress record to Stripe.
Last PaymentThe latest local subscription order or invoice payment record for this subscription.
ActionsOperational shortcuts for viewing the user, adjusting credits, syncing from Stripe, and opening the subscription in Stripe.

Available Actions

View User

Opens the WordPress user edit screen. Use this when you need to review account details, roles, profile settings, or other user metadata.

Add Credits

Opens the WordPress user edit screen and jumps directly to the BM AI Credits section. Credit changes are not made directly from the subscription list.

  1. Click Add Credits in the subscription row.
  2. The browser opens the user’s WordPress profile edit page and scrolls to BM AI Credits.
  3. Enter a positive number to add credits.
  4. Optionally enter a reason or note for the adjustment.
  5. Save the user profile.
Important: Credit adjustments are handled by WordPress, not Stripe. Adding credits does not charge the customer, create an invoice, or change the subscription price.

Sync with Stripe

Pulls the latest Stripe subscription data into the local WordPress subscription record. Use this when a subscription status, renewal date, customer ID, or plan metadata may have changed in Stripe.

The sync may update local fields such as status, current period start, current period end, Stripe customer ID, and package ID when package metadata is available.

Open in Stripe

Opens the subscription in the Stripe Dashboard. The link automatically uses the Stripe test dashboard when the SeaAI Stripe settings are in test mode.

  1. Open SeaAI > Subscriptions.
  2. Find the user by name, email, plan, or Stripe subscription ID.
  3. Check the subscription status and next renewal date.
  4. If the record looks stale, click Sync with Stripe.
  5. If the user needs a manual credit correction, click Add Credits and make the adjustment in the user profile.
  6. If payment, cancellation, invoice, refund, or card details need review, click Open in Stripe.

Responsibility Split: Stripe vs WordPress

SystemResponsible For
StripePayments, renewals, cancellations, failed payments, refunds, invoices, credit cards, taxes, billing cycle, and subscription billing state.
WordPress / SeaAIUser access, displayed plan, credit balance, credit grants, credit consumption, generation history, local subscription cache, webhook handling, and user-facing account display.
Best practice: Use WordPress for credits and user support. Use Stripe for billing, payment, cancellation, invoices, refunds, and card-related work.

Common Scenarios

A customer paid but credits are missing

  1. Open Subscriptions.
  2. Find the customer row.
  3. Click Sync with Stripe.
  4. Check Last Payment and Credits.
  5. If Stripe confirms payment but credits still need correction, click Add Credits and adjust the balance in BM AI Credits.

A subscription shows Past Due

  1. Click Open in Stripe.
  2. Review the invoice and payment failure reason in Stripe.
  3. Ask the customer to update payment details through Stripe billing tools if needed.
  4. After the issue is resolved, return to WordPress and click Sync with Stripe.

An admin needs to give bonus credits

  1. Click Add Credits.
  2. In BM AI Credits, enter the bonus amount as a positive number.
  3. Add a clear note, for example Support bonus for delayed renewal.
  4. Save the user profile.

A customer asks for a refund or cancellation

Do not handle refunds directly from WordPress. Open the subscription in Stripe and complete billing operations there. After Stripe is updated, return to WordPress and click Sync with Stripe.

Notes and Limitations

  • The subscription list is an operational management view, not a Stripe Dashboard replacement.
  • Manual credit adjustments do not affect Stripe invoices or subscription pricing.
  • Stripe sync requires valid Stripe API credentials in AI Stripe settings.
  • Webhook configuration should remain active so renewal payments and cancellations can update WordPress automatically.
  • If a Stripe subscription has no local matching record, review the checkout flow, webhook delivery, and local order records.

Was this article helpful?

Yes No

Related Articles