Skip to main content

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.

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

SurfaceUse it for
/v2/customerscustomer record used by the subscription
Payment Elementsecure card collection and pgct_ tokenization
/v2/subscriptionscreate, list, retrieve, update, and cancel subscriptions
Subscription webhookslifecycle 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.