Lister les Transactions

Obtenir une liste paginée des transactions du compte avec filtrage optionnel par date

GET /v3/account/transactions

Lister les Transactions

cURL

curl --request GET \
  --url https://api.oneclickdz.com/v3/account/transactions \
  --header 'X-Access-Token: <api-key>'

200

{
  "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>"
  }
}

​

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)

Type	Description
DEPOSIT	Argent déposé sur votre compte
REFUND-FLEXY	Remboursement d’une recharge mobile échouée
REFUND-ADSL	Remboursement d’une recharge internet échouée
REFUND-ORDER	Remboursement d’une commande de carte cadeau annulée
RECEIVE	Argent reçu d’un autre utilisateur
POINT-EXCHANGE	Points convertis en solde

​

Sortie d’Argent (Décrément)

Type	Description
FLEXY	Transaction de recharge mobile
ADSL	Transaction de recharge internet
ORDER	Commande de carte cadeau ou de produit
WITHDRAW	Argent retiré du compte
SEND	Argent envoyé à un autre utilisateur
SERVICE	Paiement ou frais de service

​

Réponse

success · boolean · requis

Indique si la requête a réussi

data · object · requis

Afficher properties

items · array · requis

Tableau d’objets de transaction

Afficher transaction object

_id · string

Identifiant unique de la transaction

type · string

Type de transaction (voir les types ci-dessus)

operation · string

Direction de l’opération : increment ou decrement

amount · number

Montant de la transaction en DZD

oldBalance · number

Solde avant la transaction

newBalance · number

Solde après la transaction

objid · string

ID de l’objet associé (ID de recharge, ID de commande, etc.)

note · string

Note de transaction optionnelle

time · string

Horodatage de la transaction (ISO 8601)

pagination · object · requis

Afficher properties

page · integer

Numéro de page actuel

pageSize · integer

Éléments par page

totalPages · integer

Nombre total de pages

totalResults · integer

Nombre total de transactions

meta · object · requis

Afficher properties

timestamp · string

Horodatage de la réponse au format ISO 8601

​

Exemples

cURL

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

​

Avec Filtrage par Date

cURL

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

Pagination

• Commencez avec des tailles de page raisonnables (20 à 50 éléments)
• Implémentez le défilement infini ou la navigation par pages
• Mettez les résultats en cache pour réduire les appels API
• Utilisez pagination.totalPages pour déterminer s’il y a d’autres données

Filtrage par Date

• 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

Performance

• 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

Affichage

• 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