Démarrage rapide

Utilisez une clé sk_test_ sur https://buy.api.yabetoopay.com — il n’y a qu’un seul hôte, c’est la clé qui porte le mode. Un abonnement créé en test reste en test pour toute sa vie.

Créez un produit et son prix récurrent

Un abonnement se construit sur un prix de type: "recurring". La cadence est portée par billingInterval et billingIntervalCount.

curl -X POST https://buy.api.yabetoopay.com/v1/prices \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "productId": "prod_...",
    "amount": 5000,
    "currency": "xaf",
    "type": "recurring",
    "billingInterval": "month",
    "billingIntervalCount": 1
  }'

billingInterval et billingIntervalCount ne sont pas rendus obligatoires par l’API sur un prix recurring. Posez-les toujours : un prix récurrent sans cadence crée un abonnement qui ne se renouvellera jamais, sans erreur.

Détail des champs : Prix.

Créez l'abonnement avec le numéro Mobile Money du client

Le client est trouvé ou créé par son e-mail. Sa méthode de paiement devient sa méthode par défaut : c’est elle qui sera sollicitée à chaque renouvellement.

curl -X POST https://buy.api.yabetoopay.com/v1/subscriptions \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "customerEmail": "ada@example.com",
    "firstName": "Ada",
    "items": [{ "priceId": "price_...", "quantity": 1 }],
    "paymentMethodData": {
      "type": "momo",
      "momo": { "country": "cg", "msisdn": "242061234567", "operator_name": "mtn" }
    },
    "idempotencyKey": "signup-ada-2026-09"
  }'

La réponse arrive après la demande de paiement — l’appel attend le résultat opérateur.

201

{
  "subscription": {
    "id": "sub_...",
    "status": "active",
    "customerEmail": "ada@example.com",
    "currentPeriodStart": "2026-09-17T10:00:00.000Z",
    "currentPeriodEnd": "2026-10-17T10:00:00.000Z",
    "nextBillingDate": "2026-10-17T10:00:00.000Z",
    "items": [{ "id": "si_...", "priceId": "price_...", "quantity": 1 }]
  },
  "paymentStatus": { "success": true, "status": "paid", "requiresAction": false },
  "invoice": { "id": "inv_...", "status": "paid" }
}

Si le client refuse ou ne répond pas, la réponse est aussi un 201 : paymentStatus.success vaut false et l’abonnement est unpaid. Voir Créer par l’API.

Écoutez les webhooks

Deux événements racontent la vie de l’abonnement :

Événement	Quand
`subscription.created`	À la création — `data.status` vaut `active`, `unpaid` ou `trialing` selon l’issue du premier paiement
`invoice.paid`	À chaque cycle réglé

La liste complète : Webhooks.

Simulez le renouvellement

En test, une horloge de test fait avancer l’abonnement jusqu’à son échéance sans attendre un mois.

Et ensuite

Cycle de vie

Les six statuts et leurs transitions.

Page hébergée

Laisser le client souscrire lui-même.

Cycle de facturation

Ce qui se passe à chaque échéance, et quand.

Référence API

L’objet et ses dix endpoints.

Pour commencer

Créer un abonnement

Gérer

Facturation

Ressources

Et ensuite

Cycle de vie

Page hébergée

Cycle de facturation

Référence API

​Et ensuite

Cycle de vie

Page hébergée

Cycle de facturation

Référence API

Et ensuite