Subscriptions

Les opérations d’abonnement sont actuellement exposées principalement à travers les routes de billing à portée marchande.

Objet Subscription

{
  "id": "sub_abc123",
  "object": "subscription",
  "customer": "cus_xyz789",
  "status": "active",
  "items": [
    { "id": "si_abc", "price": "price_premium_monthly", "quantity": 1 }
  ],
  "current_period_start": 1708300800,
  "current_period_end": 1710979200,
  "created": 1708300800
}

Famille de routes implémentée

Les routes marchandes d’abonnement actuelles incluent :

• GET /api/v1/merchant/subscriptions
• GET /api/v1/merchant/subscriptions/{id}
• POST /api/v1/merchant/subscriptions
• POST /api/v1/merchant/subscriptions/{id}/cancel

Des chemins marchands compatibles hérités peuvent aussi être disponibles sous api/merchant/*.

Lister les abonnements

GET /api/v1/merchant/subscriptions

Paramètre	Type	Description
page	integer	Numéro de page
limit	integer	Nombre de résultats par page
status	string	Filtrer par statut

Créer un abonnement

POST /api/v1/merchant/subscriptions

Annuler un abonnement

POST /api/v1/merchant/subscriptions/{id}/cancel

Note d’intégration

La documentation actuelle doit traiter les abonnements comme faisant partie de la surface de billing marchand, sauf si un contrôleur public d’abonnement distinct est explicitement exposé.