Skip to main content
GET
/
v1
/
payouts
Lister les payouts
curl --request GET \
  --url https://api.example.com/v1/payouts

​
Lister les payouts

Récupère la liste de tous vos payouts avec pagination.

​
Endpoint

GET /v1/payouts

​
Headers

HeaderRequisDescription
Authorization✅Bearer sk_xxx

​
Query Parameters

ParamètreTypeRequisDescription
pageintegerNuméro de page (défaut: 1)
limitintegerNombre de résultats par page (défaut: 20, max: 100)
statusstringFiltrer par statut (PENDING, COMPLETED, FAILED, etc.)
typestringFiltrer par type (SUPPLIER_PAYMENT, SALARY, etc.)

​
Exemple

curl "https://api.sahelpay.ml/v1/payouts?page=1&limit=20&status=COMPLETED" \
  -H "Authorization: Bearer sk_test_xxx"

​
Réponse

{
  "success": true,
  "data": {
    "payouts": [
      {
        "id": "pay_abc123",
        "reference": "PAY_abc123",
        "amount": 50000,
        "fee": 250,
        "net_amount": 49750,
        "currency": "XOF",
        "provider": "ORANGE_MONEY",
        "recipient_phone": "+22370123456",
        "status": "COMPLETED",
        "type": "SUPPLIER_PAYMENT",
        "created_at": "2025-12-18T16:45:00.000Z",
        "completed_at": "2025-12-18T16:50:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 150,
      "total_pages": 8
    }
  }
}