Clients et moyens de paiement

Un client est créé automatiquement à la première inscription d’une adresse e-mail chez vous, dans un environnement. Il porte les moyens de paiement que ses abonnements utilisent : des cartes et des numéros mobile money de n’importe quel pays, dont un par défaut. À chaque échéance, ses moyens sont essayés dans l’ordre : celui choisi pour l’abonnement, sinon celui par défaut, puis les autres. Voir Abonnements. Seul votre client ajoute un moyen de paiement, sur la page de paiement d’un abonnement ou depuis son espace client, car il faut sa carte ou son téléphone. L’API permet de les consulter, de choisir celui par défaut et d’en retirer un.

L’objet client

{
  "data": {
    "id": "cus_c71d0e5a3b2f4e8a9c1d5f6a7b8c9d01",
    "object": "customer",
    "livemode": false,
    "created": "2026-11-07T10:00:00+00:00",
    "email": "awa@example.com",
    "name": "Awa Ndiaye",
    "metadata": null,
    "default_payment_method": "pm_8e2f1a7c5d4b4c3e9a1f0b6d2e8c4a15",
    "payment_methods": [
      {
        "id": "pm_8e2f1a7c5d4b4c3e9a1f0b6d2e8c4a15",
        "object": "payment_method",
        "livemode": false,
        "created": "2026-11-07T10:00:00+00:00",
        "type": "card",
        "label": "Visa •• 4242",
        "brand": "visa",
        "last4": "4242",
        "exp_month": 9,
        "exp_year": 2029,
        "country": null,
        "provider": null,
        "phone_last_digits": null,
        "verified": true
      },
      {
        "id": "pm_3a9c6e2d1f8b4d7a8e5c2b4f6a9d1c37",
        "object": "payment_method",
        "livemode": false,
        "created": "2026-11-07T10:05:00+00:00",
        "type": "mobile_money",
        "label": "MTN Mobile Money •• 12",
        "brand": null,
        "last4": null,
        "exp_month": null,
        "exp_year": null,
        "country": "CMR",
        "provider": "MTN_MOMO_CMR",
        "phone_last_digits": "12",
        "verified": false
      }
    ],
    "subscriptions_count": 2
  }
}

Champ	Description
`default_payment_method`	`uuid` du moyen utilisé en premier, `null` si aucun
`payment_methods`	Moyens enregistrés, du plus ancien au plus récent. Renvoyé par `GET /api/v1/customers/{id}`
`verified`	`true` dès qu’un paiement a réussi avec ce moyen. Un numéro mobile money est confirmé ainsi, sans SMS
`phone_last_digits`	Les 2 derniers chiffres du numéro. Le numéro complet n’est jamais renvoyé

L’uuid du client figure aussi dans chaque abonnement, champ customer.

Par l’API

Lister les clients

Retrouvez un client par son adresse e-mail.

Lire un client

Le client et ses moyens de paiement.

Choisir le moyen par défaut

Celui essayé en premier à chaque échéance.

Retirer un moyen

Il ne sera plus jamais utilisé.

Démarrage

Paiements

Liens de paiement

Abonnements

Soldes et retraits

Développeurs