Auto-Charge Subscription Guide

How to invoke an auto-charge subscription?

1. Set collection_method = auto_charge

When creating a subscription through SubscriptionCreateRequest,
you must set the field collect_method to auto_charge.

2. Set current_period_start

You must specify the start date and time of the first billing period using the ISO 8601 format:

⚠️ Attention:
The value of current_period_start must be later than the current time (now).

3. Configure recurring Parameters

You must provide a recurring object to define the billing cycle.
Supported intervals include: week, month, or year.

In this example, the subscription will charge 500 units every week for three consecutive weeks.

How Auto-Charge Works

After customer complete the first payment, the subsciption will be active.

Each invoice is automatically charged one day before the next billing period begins.

Example: If you create a subscription with the following parameters:

Then the auto-charge schedule will be:

Billing Cycle	Billing Period	Auto-Charge Time
2nd Invoice	2025-02-01 → 2025-02-28	2025-01-31
3rd Invoice	2025-03-01 → 2025-03-31	2025-02-28

tips：

If a subscription remains inactive 24 hours after creation, it automatically transitions to incomplete_expired, permanently disabling any future auto-charge attempts.

The system attempts auto-charging at 01:00 UTC, and retried to charge at 04:00, 07:00, and 10:00 UTC.

If all automatic charge attempts fail, the subscription status will change to unpaid.

Auto-Charge Subscription Guide

How to invoke an auto-charge subscription?#

1. Set collection_method = auto_charge#

2. Set current_period_start#

3. Configure recurring Parameters#

How Auto-Charge Works#

How to invoke an auto-charge subscription?

1. Set collection_method = auto_charge

2. Set current_period_start

3. Configure recurring Parameters

How Auto-Charge Works