> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercy-pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clients et moyens de paiement

> Retrouvez un abonné et les cartes et numéros mobile money avec lesquels il paie.

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](https://docs.mercy-pay.com/subscriptions/overview.md).

Seul votre client ajoute un moyen de paiement, sur la page de paiement d'un abonnement ou depuis son [espace client](https://docs.mercy-pay.com/subscriptions/billing-portal.md), 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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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](https://docs.mercy-pay.com/api/subscriptions/create.md), champ `customer`.

## Par l'API

> [card] [Lister les clients](https://docs.mercy-pay.com/api/customers/list.md)
>
> Retrouvez un client par son adresse e-mail.

> [card] [Lire un client](https://docs.mercy-pay.com/api/customers/get.md)
>
> Le client et ses moyens de paiement.

> [card] [Choisir le moyen par défaut](https://docs.mercy-pay.com/api/customers/set-default.md)
>
> Celui essayé en premier à chaque échéance.

> [card] [Retirer un moyen](https://docs.mercy-pay.com/api/customers/remove-payment-method.md)
>
> Il ne sera plus jamais utilisé.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.