Subscriptions

Partner Administrative Operations

These are operations are useful to customer support teams, but may not be functionality exposed to end-users as part of a subscription management dashboard.

View Active Subscriptions

Partners can use this endpoint to reconcile subscription state between their system and Truemed, help support agents review or manage subscription issues, or show active subscriptions in a user’s “My Subscriptions” dashboard.

The list_payment_token endpoint provides payment_tokens for all customers associated with the partner’s account.

This endpoint allows tokens to be filtered by:

  • email
  • A range of tokens using created_at range
  • lmn_expiration
  • card_expiration

Monitor Expiration Dates

Truemed recommends a recurring background job to filter for expirations occurring within the next 30 days and emailing customers to update their payment method or retake the survey.

This proactive approach helps prevent payment failures and subscription disruptions by:

  • Identifying expiring payment methods before they cause billing issues
  • Identifying expiring Letters of Medical Necessity (LMNs) before they cause eligibility issues
  • Giving customers time to take necessary actions without interrupting their subscription

Cancel or Terminate a Subscription

Using the delete_payment_token endpoint permanently cancels a payment_token. This disables future charges — any attempt to use the token with create_payment_session will return a NotFound error.

Deletion is irreversible

  • Deletion is irreversible — tokens cannot be reactivated.
  • To support pause/resume flows or grace periods, manage that logic internally and delete the token only when final.