Passer au contenu principal
GET
/
v3
/
account
/
transactions
Lister les Transactions
curl --request GET \
  --url https://api.oneclickdz.com/v3/account/transactions \
  --header 'X-Access-Token: <api-key>'
{
  "success": true,
  "data": {
    "items": [
      {
        "_id": "<string>",
        "type": "<string>",
        "operation": "<string>",
        "amount": 123,
        "oldBalance": 123,
        "newBalance": 123,
        "objid": "<string>",
        "note": "<string>",
        "time": "<string>"
      }
    ],
    "pagination": {
      "page": 123,
      "pageSize": 123,
      "totalPages": 123,
      "totalResults": 123
    }
  },
  "meta": {
    "timestamp": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Vue d’Ensemble

Retourne une liste paginée de toutes les transactions de votre compte, incluant les dépôts, les retraits, les recharges, les remboursements et les transferts.

​
Paramètres de Requête

​
page
integer
défaut:1
Numéro de page (minimum : 1)
​
pageSize
integer
défaut:20
Éléments par page (minimum : 1, maximum : 100)
​
from
string
Date de début pour le filtrage (format ISO 8601 : 2025-10-01T00:00:00Z)
​
to
string
Date de fin pour le filtrage (format ISO 8601 : 2025-10-31T23:59:59Z)
Lors du filtrage par date, les paramètres from et to doivent être fournis ensemble.

​
Types de Transaction

​
Entrée d’Argent (Incrément)

TypeDescription
DEPOSITArgent déposé sur votre compte
REFUND-FLEXYRemboursement d’une recharge mobile échouée
REFUND-ADSLRemboursement d’une recharge internet échouée
REFUND-ORDERRemboursement d’une commande de carte cadeau annulée
RECEIVEArgent reçu d’un autre utilisateur
POINT-EXCHANGEPoints convertis en solde

​
Sortie d’Argent (Décrément)

TypeDescription
FLEXYTransaction de recharge mobile
ADSLTransaction de recharge internet
ORDERCommande de carte cadeau ou de produit
WITHDRAWArgent retiré du compte
SENDArgent envoyé à un autre utilisateur
SERVICEPaiement ou frais de service

​
Réponse

​
success
boolean
requis
Indique si la requête a réussi
​
data
object
requis
​
meta
object
requis

​
Exemples

curl https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20 \
  -H "X-Access-Token: YOUR_API_KEY"

​
Avec Filtrage par Date

curl "https://api.oneclickdz.com/v3/account/transactions?from=2025-10-01T00:00:00Z&to=2025-10-31T23:59:59Z" \
  -H "X-Access-Token: YOUR_API_KEY"

​
Exemple de Réponse

{
  "success": true,
  "data": {
    "items": [
      {
        "type": "FLEXY",
        "operation": "decrement",
        "oldBalance": 2316.129999998957,
        "amount": 990,
        "newBalance": 1326.129999998957,
        "objid": "68fe2cdd51bc170608683e3a",
        "note": "MIX1000_OOREDOO - 0554926570",
        "time": "2025-10-26T14:14:53.074Z",
        "_id": "68fe2cdd51bc170608683e40"
      },
      {
        "type": "REFUND-ORDER",
        "operation": "increment",
        "oldBalance": 316.1299999989569,
        "amount": 2000,
        "newBalance": 2316.129999998957,
        "objid": "68fcdd7cd712569c624e05ee",
        "note": "Refunded - 1 - 68fcdd7cd712569c624e05ee",
        "time": "2025-10-25T14:24:00.338Z",
        "_id": "68fcdd80d712569c624e069d"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 5,
      "totalPages": 105,
      "totalResults": 521
    }
  },
  "meta": {
    "timestamp": "2025-10-29T00:35:58.852Z"
  }
}

​
Cas d’Utilisation

Historique des Transactions

Affichez l’historique des transactions aux utilisateurs dans votre application

Comptabilité et Rapports

Générez des rapports et des relevés financiers

Réconciliation du Solde

Vérifiez les variations du solde et effectuez des audits de transactions

Activité Utilisateur

Suivez les habitudes de dépenses et le comportement des utilisateurs

​
Bonnes Pratiques

  • Fournissez toujours les paramètres from et to ensemble - Utilisez le format ISO 8601 pour les dates - Définissez des plages horaires appropriées pour les rapports - Tenez compte des différences de fuseau horaire lors du filtrage
  • Mettez en cache les données de transaction localement si possible - Utilisez des filtres de date pour limiter les ensembles de résultats - Implémentez une interface de pagination appropriée - Envisagez des notifications webhook pour les mises à jour en temps réel
  • Affichez le type de transaction dans un langage convivial
  • Affichez les montants avec un formatage de devise approprié
  • Incluez les horodatages dans le fuseau horaire local
  • Liez les transactions aux objets associés (recharges, commandes)

​
Endpoints Associés

Obtenir le Solde

Vérifier le solde actuel du compte