# Lire un retrait

`GET https://api.payiz.app/v1/payouts/{id}`

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

Un retrait, et ce qu’il est devenu.

## Ce qu'on reçoit

`200` · un objet `payout`

| Champ | Type | Requis | Ce que c'est |
| --- | --- | --- | --- |
| `object` | « payout » | — | Le genre de l’objet rendu : il ne change jamais. |
| `id` | texte | — | Un identifiant préfixé « ret_ », par exemple ret_01j9x3kq7m4tzv8qhw2n. |
| `amount` | entier | — | Ce que le bénéficiaire reçoit. |
| `currency` | texte | — | Le code ISO 4217, en majuscules. |
| `status` | « pending » · « in_review » · « processing » · « paid » · « failed » · « refused » · « canceled » | — | Où en est le retrait. |
| `fee` | entier | — | Les frais du retrait. |
| `amount_debited` | entier | — | Ce qui sort du solde, frais compris. |
| `recipient` | objet | — | Vers qui l’argent part. |
| `failure_message` | texte ou null | — | Ce que l’opérateur a répondu, quand ça a échoué. |
| `paid_at` | entier ou null | — | Des secondes depuis 1970, ou null. |
| `created` | entier ou null | — | Des secondes depuis 1970, ou null. |
| `livemode` | vrai ou faux | — | Faux en mode test : aucun argent ne circule. |

## La demande

```bash
curl https://api.payiz.app/v1/payouts/ret_01j9xe9np6w7rzc5mb4d \
  -H "Authorization: Bearer sk_test_…"
```

## La réponse

```json
{
  "object": "payout",
  "id": "ret_01j9xe9np6w7rzc5mb4d",
  "amount": 50000,
  "currency": "XOF",
  "status": "processing",
  "fee": 500,
  "amount_debited": 50500,
  "recipient": {
    "id": "ben_01j9xd7mk4s2pvb8ya3c",
    "name": "Adjoa Mensah",
    "phone": "+229 01 •• •• 34 00",
    "operator": "mtn",
    "country": "BEN"
  },
  "failure_message": null,
  "paid_at": null,
  "created": 1790009892,
  "livemode": false
}
```