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

# Limites de débit

> Nombre de requêtes autorisées par minute, par clé API.

Chaque clé API a deux compteurs séparés, par minute :

| Requêtes | Limite |
| - | - |
| Lectures : `GET` et [`POST /api/v1/fees/quote`](https://docs.mercy-pay.com/api/fees/quote) | **300 par minute** |
| Écritures : toutes les autres `POST`, `PATCH` et `DELETE` | **60 par minute** |

Au-delà, l'API répond `429 Too Many Requests`. Une lecture ne consomme jamais votre quota d'écriture. Les compteurs se réinitialisent chaque minute.

Cette limite ne concerne que ce que vous envoyez. Les webhooks que vous recevez ne la consomment pas.

## En-têtes de réponse

Chaque réponse indique votre quota courant :

| En-tête | Description |
| - | - |
| `X-RateLimit-Limit` | Le plafond du compteur concerné : `300` pour une lecture, `60` pour une écriture |
| `X-RateLimit-Remaining` | Requêtes restantes sur la minute en cours |

Une réponse `429` ajoute en plus :

| En-tête | Description |
| - | - |
| `Retry-After` | Secondes à attendre avant de réessayer |
| `X-RateLimit-Reset` | Timestamp Unix de la réinitialisation du quota |

## Bonnes pratiques

* Évitez de sonder `GET /api/v1/payments/{id}` en boucle : écoutez plutôt les webhooks, voir [Webhooks](https://docs.mercy-pay.com/developers/webhooks/overview.md).
* Étalez les envois en masse sur plusieurs minutes.


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