Aller au contenu principal

Statistiques de Dépôt

Accédez aux métriques agrégées pour l'intelligence d'affaires, les tableaux de bord et le suivi des performances.

Endpoint​

GET /api/v2/deposit/statistics

Paramètres de Requête​

ParamètreTypeRequisDescription
startDatestringNonDate ISO 8601 (par défaut : il y a 30 jours)
endDatestringNonDate ISO 8601 (par défaut : maintenant)
groupBystringNonGrouper les résultats par : day, week, month, gateway, status

Exemple Sandbox​

curl -X GET "https://sandbox.awdpay.com/test/api/v2/deposit/statistics?startDate=2025-11-01T00:00:00Z&endDate=2025-11-30T23:59:59Z&groupBy=gateway" \
  -H "Authorization: Bearer $AWDPAY_TOKEN"

Réponse​

{
  "period": {
    "startDate": "2025-11-01T00:00:00Z",
    "endDate": "2025-11-30T23:59:59Z"
  },
  "summary": {
    "totalTransactions": 1247,
    "totalVolume": 62350000.0,
    "totalFees": 1299840.0,
    "currency": "XOF",
    "successRate": 96.5,
    "averageAmount": 50000.0
  },
  "byGateway": [
    {
      "gatewayName": "wave-senegal",
      "transactions": 478,
      "volume": 23900000.0,
      "fees": 502160.0,
      "successRate": 98.1
    },
    {
      "gatewayName": "orange-money-sn",
      "transactions": 352,
      "volume": 17600000.0,
      "fees": 370240.0,
      "successRate": 95.7
    },
    {
      "gatewayName": "free-money-sn",
      "transactions": 287,
      "volume": 14350000.0,
      "fees": 302080.0,
      "successRate": 94.8
    },
    {
      "gatewayName": "mtn-momo-ci",
      "transactions": 130,
      "volume": 6500000.0,
      "fees": 136760.0,
      "successRate": 97.2
    }
  ],
  "byStatus": {
    "completed": 1203,
    "failed": 28,
    "pending": 12,
    "expired": 4
  },
  "trends": [
    {
      "date": "2025-11-01",
      "transactions": 38,
      "volume": 1900000.0,
      "successRate": 97.4
    },
    {
      "date": "2025-11-02",
      "transactions": 42,
      "volume": 2100000.0,
      "successRate": 95.2
    }
    // ... plus de données quotidiennes
  ]
}

Métriques Expliquées​

  • totalVolume : somme de toutes les valeurs amount (hors frais)
  • totalFees : somme de tous les frais de traitement
  • successRate : pourcentage de transactions completed
  • averageAmount : valeur moyenne de transaction

Cas d'Usage​

  • Tableaux de bord d'affaires : visualiser les tendances de revenus au fil du temps
  • Performance des passerelles : comparer les taux de succès entre fournisseurs
  • Planification financière : prévoir les revenus mensuels basés sur les données historiques
  • Analyse des coûts : suivre les dépenses de frais par passerelle

Exemple : Tendances Quotidiennes​

curl -X GET "https://sandbox.awdpay.com/test/api/v2/deposit/statistics?groupBy=day&startDate=2025-11-01T00:00:00Z&endDate=2025-11-30T23:59:59Z" \
  -H "Authorization: Bearer $AWDPAY_TOKEN"

Exemple : Répartition par Statut​

curl -X GET "https://sandbox.awdpay.com/test/api/v2/deposit/statistics?groupBy=status" \
  -H "Authorization: Bearer $AWDPAY_TOKEN"
Intégration Tableau de Bord

Utilisez le tableau trends pour alimenter les graphiques dans votre panneau d'administration ou outils BI comme Metabase, Tableau ou Power BI.

Prochaines Étapes​