> ## 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.

# Subscriptions Overview

> Create recurring card billing with customers, Payment Element tokens, renewals, retries, and subscription webhooks.

Use subscriptions when you need to charge the same customer on a recurring schedule.

## How it works

1. Create the customer with `POST /v2/customers`.
2. Collect the card with Payment Element in `mode: "subscription"`.
3. Send the single-use `pgct_` token to your backend.
4. Create the subscription with `POST /v2/subscriptions`.
5. Listen to subscription webhooks for renewals, failures, updates, and cancellation.

## Main surfaces

| Surface               | Use it for                                                      |
| --------------------- | --------------------------------------------------------------- |
| `/v2/customers`       | customer record used by the subscription                        |
| Payment Element       | secure card collection and `pgct_` tokenization                 |
| `/v2/subscriptions`   | create, list, retrieve, update, and cancel subscriptions        |
| Subscription webhooks | lifecycle events such as created, renewed, failed, and canceled |

## Operating rules

* Create subscriptions only from your backend.
* Store the Pagou subscription `id`, customer `id`, and latest transaction `id`.
* Use webhooks as the normal source of truth for lifecycle changes.
* Reconcile with `GET /v2/subscriptions/{id}` when a renewal or cancellation outcome is unclear.
* Create a new subscription to change immutable fields such as amount, currency, interval, or card.

## Read next

* [Create a Subscription](/subscriptions/create)
* [Subscription Lifecycle](/subscriptions/lifecycle)
* [Subscription Webhooks](/subscriptions/webhooks)
* [Subscriptions API Reference](/api-reference/subscriptions/reference)