Use the subscription status to decide customer access and operational follow-up.Documentation Index
Fetch the complete documentation index at: https://developer.pagou.ai/llms.txt
Use this file to discover all available pages before exploring further.
Statuses
| Status | Meaning | Recommended action |
|---|---|---|
incomplete | first charge or validation did not finish | wait for recovery or reconcile |
trialing | trial period is active | grant trial access until trial_end |
active | billing is current | keep access active |
past_due | renewal failed and retry policy applies | notify the customer and wait for retry or cancellation |
cancel_scheduled | cancellation is scheduled for period end | keep access until current_period_end |
canceled | subscription is finished | stop future access and billing |
Renewals
Pagou renews active and trialing subscriptions when the billing period ends. Successful renewals emitsubscription.started after a trial or subscription.renewed for later cycles.
Failed payments
failure_policy controls what happens after a failed renewal:
retry_then_cancel: move through retry handling before cancellation.immediate_cancel: cancel when the renewal cannot be collected.
retry_offsets_days only when you need explicit retry spacing.
Cancellation
POST /v2/subscriptions/{id}/cancel schedules cancellation at the end of the current period. The subscription becomes cancel_scheduled immediately and later moves to canceled.