> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sahelpay.ml/llms.txt
> Use this file to discover all available pages before exploring further.

# Récupérer un payout

> Obtenir les détails d'un payout

# Récupérer un payout

Récupère les détails d'un payout par sa référence.

## Endpoint

```
GET /v1/payouts/{id}
```

## Headers

| Header          | Requis | Description     |
| --------------- | ------ | --------------- |
| `Authorization` | ✅      | `Bearer sk_xxx` |

## Paramètres

| Paramètre | Type   | Requis | Description                            |
| --------- | ------ | ------ | -------------------------------------- |
| `id`      | string | ✅      | Référence du payout (ex: `PAY_abc123`) |

## Exemple

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.sahelpay.ml/v1/payouts/PAY_abc123 \
    -H "Authorization: Bearer sk_test_xxx"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch('https://api.sahelpay.ml/v1/payouts/PAY_abc123', {
    headers: {
      'Authorization': 'Bearer sk_test_xxx',
    },
  });
  ```
</CodeGroup>

## Réponse

```json theme={null}
{
  "success": true,
  "data": {
    "id": "pay_abc123def456",
    "reference": "PAY_abc123def456",
    "amount": 50000,
    "fee": 250,
    "net_amount": 49750,
    "currency": "XOF",
    "provider": "ORANGE_MONEY",
    "recipient_phone": "+22370123456",
    "recipient_name": "Mamadou Diallo",
    "type": "SUPPLIER_PAYMENT",
    "status": "COMPLETED",
    "description": "Paiement fournisseur #123",
    "external_ref": "OM_123456",
    "completed_at": "2025-12-18T16:50:00.000Z",
    "created_at": "2025-12-18T16:45:00.000Z"
  }
}
```

## Statuts possibles

* `PENDING` : En attente de traitement
* `PROCESSING` : En cours de traitement
* `COMPLETED` : Paiement effectué avec succès
* `FAILED` : Échec du paiement
* `CANCELLED` : Annulé