> ## 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.

# Liens de paiement

> Créez un lien réutilisable, payable par autant de clients que nécessaire.

Voir [Liens de paiement](/concepts/payment-links) pour le fonctionnement général et [Créer un lien de paiement](/guides/create-a-payment-link) pour un exemple complet.

## POST /api/v1/payment-links

Crée un lien de paiement.

### Corps

| Champ | Requis | Type | Règles |
| - | - | - | - |
| `title` | oui | chaîne | 255 caractères maximum |
| `currency` | oui | chaîne | Code ISO 4217 de 3 lettres |
| `description` | non | chaîne | 500 caractères maximum |
| `amount` | non | entier | Unités mineures. Omis = le client choisit son montant |
| `minimum_amount` | non | entier | Plancher appliqué uniquement si `amount` est omis |
| `expires_at` | non | date | Doit être dans le futur |
| `success_url`, `cancel_url` | non | URL | Transmis à chaque session créée via ce lien |

```bash theme={null}
curl https://mercy-pay.com/api/v1/payment-links \
  -H "Authorization: Bearer mp_live_XXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Consultation",
    "currency": "XAF",
    "amount": 10000
  }'
```

### Réponse `201`

```json theme={null}
{
  "data": {
    "uuid": "7c9e4e2a-1b3d-4a5e-8f6c-2d9b1a7e3c48",
    "title": "Consultation",
    "description": null,
    "amount": 10000,
    "minimum_amount": null,
    "currency": "XAF",
    "is_active": true,
    "expires_at": null,
    "uses_count": 0,
    "url": "https://mercy-pay.com/pay/a1b2c3d4",
    "created_at": "2026-10-04T16:00:00+00:00"
  }
}
```

`url` est le lien à partager tel quel. Il n'y a rien à construire à partir de `uuid` ou d'un autre champ.

## GET /api/v1/payment-links

Liste vos liens de paiement, du plus récent au plus ancien.

| Paramètre | Description |
| - | - |
| `per_page` | 20 par défaut, 100 au maximum |

## GET /api/v1/payment-links/{uuid}

Renvoie un lien, avec la même structure que la réponse de création.

### Erreurs

| Code | Cause |
| - | - |
| `404` | Lien inconnu, ou appartenant à un autre marchand |
| `422` | Champs invalides, avec le détail dans `errors` |

Activer ou désactiver un lien existant se fait depuis le tableau de bord pour l'instant, pas par l'API.


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