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 ≤ periodCount < 7 | Specification is not supported |
| 7 ≤ periodCount < 30 | 1 ≤ advanceDays ≤ 2 | |
| 30 ≤ periodCount < 90 | 1 ≤ advanceDays ≤ 5 | |
| periodCount ≥ 90 | 1 ≤ advanceDays ≤ 7 | |
| W (week) | 1 ≤ periodCount < 4 | 1 ≤ advanceDays ≤ 2 |
| 4 ≤ periodCount < 12 | 1 ≤ advanceDays ≤ 5 | |
| periodCount ≥ 12 | 1 ≤ advanceDays ≤ 7 | |
| M (month) | 1 ≤ periodCount < 3 | 1 ≤ advanceDays ≤ 5 |
| periodCount ≥ 3 | 1 ≤ advanceDays ≤ 7 | |
| Y (year) | 1 ≤ periodCount ≤ 3 | 1 ≤ 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 Value | Status Description | Remarks |
| INACTIVE | Inactive | After creating a subscription plan, the status is Inactive |
| ACTIVE_FAILED | Activation Failed | Status after failed activation |
| ACTIVE | Effective | Status after successful activation |
| TER MINATE | Subscription Termination | If a payment for a certain period fails, the subscription plan will be terminated |
| CANCEL | Subscription Cancellation | Actively cancel the subscription plan |
| FINISH | Subscription Completion | All subscription periods have been deducted |
| EXPIRED | Expired and Not Activated | The subscription plan has not been activated after the first payment period has started |
4. Subscription Deduction Status
| Status Value | Status Description |
| PENDING | Debit in Progress |
| SUCCESS | Debit Successful |
| FAILED | Debit Failed |