# Lister les remboursements

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

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

Filtrable par paiement et par statut.

## Ce qu'on met dans l'adresse

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `payment` | texte | — | Les remboursements de ce paiement-là. |
| `status` | « pending » · « processing » · « succeeded » · « failed » | — | Ne rendre que ceux dans cet état. |
| `limit` | entier | — | De 1 à 100. Par défaut 20. |
| `starting_after` | texte | — | L’identifiant de la dernière ligne lue : la page suivante commence après. |

## Ce qu'on reçoit

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

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « list » | — | Le genre de l’objet rendu : il ne change jamais. |
| `data` | liste d’objets refund | — | Les remboursements 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/refunds \
  -H "Authorization: Bearer sk_test_…" \
  -d payment=pay_01j9x3kq7m4tzv8qhw2n
```

## La réponse

```json
{
  "object": "list",
  "url": "/v1/refunds",
  "has_more": false,
  "data": [
    {
      "object": "refund",
      "id": "rem_01j9xb2te8r5mzq4kd7n",
      "payment": "pay_01j9x3kq7m4tzv8qhw2n",
      "amount": 10000,
      "currency": "XOF",
      "status": "processing",
      "reason": "requested_by_customer",
      "fee": 100,
      "fee_returned": 250,
      "amount_debited": 9850,
      "failure_message": null,
      "created": 1790006292,
      "livemode": false
    }
  ]
}
```