wallets

GET /api/v1/merchant/reports/wallets HTTP/1.1
Host: api.example.com
Authorization: Bearer <access-token>
Accept: application/json

curl "https://api.example.com/api/v1/merchant/reports/wallets" \
  --header "Authorization: Bearer ${QOS_ACCESS_TOKEN}" \
  --header "Accept: application/json"

Réponse réussie — HTTP 200

{
  "data": [
    {
      "id": 301,
      "name": "Primary NGN Wallet",
      "currencyCode": "NGN",
      "availableBalance": 150000.0,
      "ledgerBalance": 150000.0,
      "isDefault": true
    }
  ],
  "message": "Wallets retrieved successfully",
  "success": true,
  "responseCode": "00"
}

availableBalance correspond au solde disponible pour de nouvelles opérations de débit. ledgerBalance correspond au solde enregistré dans le grand livre. Utilisez id lorsque vous filtrez l’historique du wallet. Un marchand peut disposer d’un wallet par défaut et de wallets dédiés à certains providers pour une même devise.