Skip to content

PayerMax Manage Subscription Plans

1. Interaction Process

2. Subscription Plan Rules

  • PayerMax offers various subscription plans: standard subscription, n-day trial subscription, and first n periods discount subscription. When creating a subscription plan, you can specify different parameters to create different types of subscription plans.

  • PayerMax-managed subscription plans cannot exceed a total duration of three years.

  • After creating a subscription plan, activation must be completed before the first payment is due. If the first payment is more than 24 hours after the subscription creation date, activation must be completed within 24 hours. Otherwise, the subscription plan will be marked as expired, and PayerMax will notify you of the expiration.

  • After activating a subscription plan, subsequent payments will be initiated by PayerMax.

    • Trial scenario: Payment will be initiated 24 hours before the end of the trial period (the first payment). If the payment fails, the plan will be retried three times. If the payment fails, the subscription will be terminated.

    • Subsequent debit logic:

      • Default logic: Debits will be made within 24 hours of the start of the current period. If the debit fails, the system will automatically retry within 24 hours. If the retry fails after three attempts, the subscription will be terminated.

      • You can specify the number of days in advance for debits as follows. If the debit fails, the system will retry three times each day. If the final debit fails on the last day, the subscription will be terminated.

Subscription period type (periodUnit)Period type count (periodCount)Specify the number of days for advance deduction (advanceDays)
D (Days)1 ≤ d < 7Specification is not supported
7 ≤ d < 301 ≤ advanceDays ≤ 2
30 ≤ d < 901 ≤ advanceDays ≤ 5
d ≥ 901 ≤ advanceDays ≤ 7
W (week)1 ≤ w < 41 ≤ advanceDays ≤ 2
4 ≤ w < 121 ≤ advanceDays ≤ 5
w ≥ 121 ≤ advanceDays ≤ 7
M (month)1 ≤ m < 3 1 ≤ advanceDays ≤ 5
m ≥ 31 ≤ advanceDays ≤ 7
Y (year)1 ≤ y ≤ 31 ≤ advanceDays ≤ 7

Example:

If the subscription plan is set to every 7 days, you can specify 1 day or 2 days in advance,
If the subscription plan is set to every 3 months, you can specify 1-7 days in advance.

3. Subscription Plan Status

Status ValueStatus DescriptionRemarks
INACTIVEInactiveAfter creating a subscription plan, the status is Inactive
ACTIVE_FAILEDActivation FailedStatus after failed activation
ACTIVEEffectiveStatus after successful activation
TER MINATESubscription TerminationIf a payment for a certain period fails, the subscription plan will be terminated
CANCELSubscription CancellationActively cancel the subscription plan
FINISHSubscription CompletionAll subscription periods have been deducted
EXPIREDExpired and Not ActivatedThe subscription plan has not been activated after the first payment period has started

4. Subscription Deduction Status

Status ValueStatus Description
PENDINGDebit in Progress
SUCCESSDebit Successful
FAILEDDebit Failed

Was this page helpful?

Thank you for your help in improving PayerMax Product Docs!

Last updated:

Released under the MIT License.