Skip to content

PayerMax Manage Subscription Plans

1. Interaction Process

2. Subscription Plan Rules

PayerMax Subscription Plan service provides merchants with a flexible periodic payment deduction solution. It supports various subscription models to meet the needs of different business scenarios.

2.1 Supported Subscription Types

  • Standard Subscription: An automatic payment deduction service at fixed intervals.

  • Trial Subscription: Services that offer free or low-cost trial periods before transitioning to paid subscriptions.

  • Promotional Period Subscription: A service where the initial periods are offered at a discounted price.

2.2 Service Limitation Descriptions

Special Reminder:

The total duration of a single subscription plan managed by PayerMax must not exceed 3 years.

Subscription plans must be activated within the specified time frame. The specific requirements are as follows:

  1. The subscription plan must be activated within 24 hours of its creation;

  2. Subscription plans not activated within the specified time will be marked by the system as Expired - Not Activated, and PayerMax will send an expiration notification to the merchant.

2.3 Payment Deduction and Notification Rules

2.3.1 Payment Deduction Result Notification Rules

Deduction ResultNotification TimingDescription
Payment SuccessImmediate NotificationUpon successful payment, the system immediately sends a notification to the merchant.
Payment FailureDelayed NotificationA notification is sent to the merchant only after the final deduction attempt for that period has failed.

2.3.2 Payment Failure Retry Mechanism

When a payment deduction fails, PayerMax automatically executes a retry mechanism:

  • The system will not send failure notifications to the merchant during the retry period to avoid frequent notifications impacting the merchant's system.

  • The retry strategy is executed automatically based on the merchant's configured deduction strategy (default strategy / early payment strategy / grace period strategy).

  • A final failure notification is sent only after all retry attempts have failed.

2.4 Payment Failure Handling Strategies

2.4.1 Default Handling Strategy

Strategy Description:

After the subscription is activated, subsequent payments are automatically initiated by the PayerMax system. If a payment fails, the system retries 3 times per day. If the payment still fails on the last attempt of the last day of the period, the subscription plan is automatically terminated.

2.4.2 Non-Termination on Payment Failure Strategy

Strategy Description:

If the final retry attempt for a period fails, the subscription plan does not terminate. The subscription status remains active. Payment for that period cannot continue, but when the next period begins, the system will initiate payments normally.

Configuration Method:

This strategy requires configuration by contacting the PayerMax technical support team. The configuration takes effect at the merchant account level. Once configured, it applies immediately to all subscription plans under that merchant account.

2.5 Payment Timing Strategies

Special Reminder:

If the merchant does not contact PayerMax technical support to configure a grace period deduction strategy, PayerMax will execute the default deduction strategy.

2.5.1 Default Payment Strategy

Execution Process:

  1. The system generates the next period's payment invoice 1 day in advance.

  2. The payment deduction is initiated immediately after the invoice is generated.

  3. If the payment fails, the system retries 3 times per day.

  4. If all 3 retry attempts fail, the merchant's configured payment failure handling strategy is executed.

2.5.2 Grace Period Payment Strategy

Strategy Description:

The grace period payment strategy refers to the system continuing to attempt payment during a grace period after a normal payment failure. This provides users with an additional payment window, preventing immediate subscription termination due to short-term financial issues.

Configuration Method:

Contact the PayerMax technical support team for configuration.

  • Configuration Level: Applied at the merchant account level.
  • Effective Timing: Takes effect when generating the next period's payment invoice after configuration is complete.

Execution Process:

  1. The system generates the payment invoice and initiates the deduction 1 day in advance.

  2. If the payment fails, the system retries 3 times per day.

  3. If all 3 retry attempts fail, the subscription enters the grace period.

  4. During the grace period, the system performs 1 deduction attempt on each specified date.

  5. If any deduction is successful during the grace period, subsequent attempts are stopped.

  6. If the deduction fails on the last day of the grace period, the merchant's configured payment failure handling strategy is executed.

Grace Period Deduction Date Rules:

Subscription Period TypePeriod Count RangeDeductible Dates in Grace Period
periodUnit=Day(D)1 ≤ periodCount < 7Day 1
7 ≤ periodCount < 30Days 1, 2, 5
30 ≤ periodCount < 90Days 1, 2, 5, 7, 10
periodCount ≥ 90Days 1, 2, 5, 7, 10, 15
periodUnit=Week(W)1 ≤ periodCount < 4Days 1, 2, 5
4 ≤ periodCount < 12Days 1, 2, 5, 7, 10
periodCount ≥ 12Days 1, 2, 5, 7, 10, 15
periodUnit=Month(M)1 ≤ periodCount < 3Days 1, 2, 5, 7, 10
periodCount ≥ 3Days 1, 2, 5, 7, 10, 15
periodUnit=Year(Y)1 ≤ periodCount ≤ 3Days 1, 2, 5, 7, 10, 15

Examples:

  • Example 1: Subscription period is every 7 days, with a 5-day grace period.

    • After normal payment failure, the system performs 1 deduction attempt on Day 1, Day 2, and Day 5 after the period starts.
    • If any deduction is successful during this time, subsequent attempts are stopped.
    • If all grace period deductions fail, the payment failure handling strategy is executed.
  • Example 2: Subscription period is every 3 months, with a 15-day grace period.

    • After normal payment failure, the system performs 1 deduction attempt on Day 1, Day 2, Day 5, Day 7, Day 10, and Day 15 after the period starts.
    • If any deduction is successful during this time, subsequent attempts are stopped.
    • If all grace period deductions fail, the payment failure handling strategy is executed.

2.6 Strategy Configuration Instructions

2.6.1 Configuration Level

All payment strategy configurations are applied at the merchant account level. Once configured, they take effect for subscription plans under that merchant account.

2.6.2 Configuration Effective Timing

Strategy TypeEffective Timing
Payment Failure Handling StrategyTakes effect immediately for all subscription plans after configuration.
Grace Period Payment StrategyTakes effect when generating the next period's payment invoice after configuration is complete.

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.