Skip to content

Subscription Payments

Subscriptions are provided by Checus, enabling merchants to integrate recurring billing via Checkout, API, or Frontend Components to charge users on a periodic basis.

Key Advantages:

  • Support complex subscription models (trial period, discounted period, price changes, etc.)
  • Built-in subscription lifecycle management (automatic retry, failure termination, status callbacks)
  • Users are exempt from re-entering payment details, greatly improving renewal success rate
  • Flexible integration options: API, Checkout, Frontend Components, etc.

Currently, the subscription model supports card payments only.

Subscription Plan Types and Rules

Subscription Plan Types

TypeDescription
Standard PlanCharges on a fixed cycle; the price is the same for all periods.
Trial (n days)The first period is a free trial; it automatically enters normal billing afterward.
Discounted First n PeriodsDiscounted price for the first n periods; subsequent periods are charged at the original price.

Subscription Plan Time Rules

  • Total duration must be ≤ 3 years
  • After creation the status is INACTIVE; it must be activated before the “first charge time”
  • If the first charge time is more than 24 hours after creation, it must be activated within 24 hours after creation, otherwise it will be set to EXPIRED

Lifecycle Management

Subscription Plan Status

StatusDescriptionNotes
INACTIVENot activatedDefault after creation
ACTIVE_FAILEDActivation failedActivation request failed
ACTIVEActiveActivation succeeded
TERMINATESubscription terminatedTerminated after a failed charge in some period
CANCELCanceledCanceled by merchant/user
FINISHCompletedAll periods charged successfully
EXPIREDExpired (not activated)Not activated within the time limit

Charge Status

StatusDescription
PENDINGCharging
SUCCESSCharge success
FAILEDCharge failed

User Flow

  1. The user selects a subscription service on the merchant’s page.
  2. The user is redirected to the Checus payment page to complete the first payment and authorization.
  3. Checus returns the subscription creation result (status is INACTIVE).
  4. After the first payment succeeds, Checus activates the subscription (status becomes ACTIVE).
  5. Upon each due date, Checus automatically initiates the charge and notifies the merchant of the result.
  6. The user can proactively cancel the subscription on the merchant’s page.

Note: The first-time binding and payment experience is consistent with a normal card payment.

Released under the MIT License.