# Lister les moyens de paiement

`GET https://api.payiz.app/v1/payment_methods`

Demande une clé secrète qui porte le geste « Paiements · lire ».

Les pays et opérateurs par lesquels vos payeurs peuvent régler.

De quoi construire votre écran : l’indicatif, les préfixes et les bornes de chaque opérateur. Avec « amount », la commission et ce que le payeur paiera ; avec « phone », les seuls opérateurs de ce numéro.

## Ce qu'on met dans l'adresse

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `amount` | entier | — | Un montant, dans la monnaie du paiement : chaque moyen dit alors ses frais et ce que le payeur paiera. |
| `currency` | texte | — | La monnaie du paiement ; sans précision, celle de votre espace. |
| `phone` | texte | — | Un numéro : seuls les opérateurs qui peuvent le prendre sont rendus. |
| `country` | texte | — | Un pays, en ISO 3166-1 alpha-3. |

## Ce qu'on reçoit

`200` · une liste d’objets `payment_method`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « list » | — | Le genre de l’objet rendu : il ne change jamais. |
| `data` | liste d’objets payment_method | — | Les moyens de paiement de la page, du plus récent au plus ancien. |
| `has_more` | vrai ou faux | — | Vrai : il en reste. Rappelez avec starting_after sur la dernière ligne lue. |
| `url` | texte | — | L’adresse qui a servi, sans les filtres. |

## La demande

```bash
curl -G https://api.payiz.app/v1/payment_methods \
  -H "Authorization: Bearer sk_test_…" \
  -d amount=10000 \
  -d country=BEN
```

## La réponse

```json
{
  "object": "list",
  "url": "/v1/payment_methods",
  "has_more": true,
  "data": [
    {
      "object": "payment_method",
      "country": "BEN",
      "dial_code": "+229",
      "operator": {
        "code": "mtn",
        "name": "MTN",
        "logo_url": "https://pay.payiz.app/api/public/logos/operateurs/opr_01m347jmgpa3aenhmhy4mebrc9"
      },
      "phone_prefixes": [
        "0196",
        "0197",
        "0161",
        "0162",
        "0151"
      ],
      "currency": "XOF",
      "min_amount": 100,
      "max_amount": 2000000,
      "fee": 250,
      "amount_to_pay": 10000
    },
    {
      "object": "payment_method",
      "country": "BEN",
      "dial_code": "+229",
      "operator": {
        "code": "moov",
        "name": "Moov",
        "logo_url": null
      },
      "phone_prefixes": [
        "0194",
        "0195",
        "0160",
        "0163"
      ],
      "currency": "XOF",
      "min_amount": 100,
      "max_amount": 2000000,
      "fee": 250,
      "amount_to_pay": 10000
    }
  ]
}
```