Lister les Transactions

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

const options = {method: 'GET', headers: {'X-Access-Token': '<api-key>'}};

fetch('https://api.oneclickdz.com/v3/account/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.oneclickdz.com/v3/account/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Access-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.oneclickdz.com/v3/account/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Access-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.oneclickdz.com/v3/account/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Access-Token"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

GET

account

transactions

Lister les Transactions

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

const options = {method: 'GET', headers: {'X-Access-Token': '<api-key>'}};

fetch('https://api.oneclickdz.com/v3/account/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.oneclickdz.com/v3/account/transactions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-Access-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.oneclickdz.com/v3/account/transactions"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-Access-Token", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.oneclickdz.com/v3/account/transactions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-Access-Token"] = '<api-key>'

response = http.request(request)
puts response.read_body

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

integer

défaut:1

Numéro de page (minimum : 1)

integer

défaut:20

Éléments par page (minimum : 1, maximum : 100)

string

Date de début pour le filtrage (format ISO 8601 : 2025-10-01T00:00:00Z)

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

boolean

requis

Indique si la requête a réussi

object

requis

Afficher properties

array

requis

Tableau d’objets de transaction

Afficher transaction object

string

Identifiant unique de la transaction

string

Type de transaction (voir les types ci-dessus)

string

Direction de l’opération : increment ou decrement

number

Montant de la transaction en DZD

number

Solde avant la transaction

number

Solde après la transaction

string

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

string

Note de transaction optionnelle

string

Horodatage de la transaction (ISO 8601)

object

requis

Afficher properties

integer

Numéro de page actuel

integer

Éléments par page

integer

Nombre total de pages

integer

Nombre total de transactions

object

requis

Afficher properties

string

Horodatage de la réponse au format ISO 8601

Exemples

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

const response = await fetch(
  "https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20",
  {
    headers: { "X-Access-Token": "YOUR_API_KEY" },
  }
);
const { data } = await response.json();
const transactions = data.items;
const pagination = data.pagination;

import requests

response = requests.get(
    'https://api.oneclickdz.com/v3/account/transactions',
    headers={'X-Access-Token': 'YOUR_API_KEY'},
    params={'page': 1, 'pageSize': 20}
)
data = response.json()['data']
transactions = data['items']
pagination = data['pagination']

<?php
$ch = curl_init();
$url = 'https://api.oneclickdz.com/v3/account/transactions?page=1&pageSize=20';
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['X-Access-Token: YOUR_API_KEY']);
$response = curl_exec($ch);
$data = json_decode($response, true);
$transactions = $data['data']['items'];
?>

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"

const from = "2025-10-01T00:00:00Z";
const to = "2025-10-31T23:59:59Z";
const response = await fetch(
  `https://api.oneclickdz.com/v3/account/transactions?from=${from}&to=${to}`,
  { headers: { "X-Access-Token": "YOUR_API_KEY" } }
);

response = requests.get(
    'https://api.oneclickdz.com/v3/account/transactions',
    headers={'X-Access-Token': 'YOUR_API_KEY'},
    params={
        'from': '2025-10-01T00:00:00Z',
        'to': '2025-10-31T23:59:59Z'
    }
)

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

Référence API

Core

Compte

Recharges mobiles

Recharges internet

Cartes cadeaux

Navio

Lister les Transactions

Vue d’Ensemble

Paramètres de Requête

Types de Transaction

Entrée d’Argent (Incrément)

Sortie d’Argent (Décrément)

Réponse

Exemples

Avec Filtrage par Date

Exemple de Réponse

Cas d’Utilisation

Historique des Transactions

Comptabilité et Rapports

Réconciliation du Solde

Activité Utilisateur

Bonnes Pratiques

Endpoints Associés

Obtenir le Solde

​Vue d’Ensemble

​Paramètres de Requête

​Types de Transaction

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

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

​Réponse

​Exemples

​Avec Filtrage par Date

​Exemple de Réponse

​Cas d’Utilisation

Historique des Transactions

Comptabilité et Rapports

Réconciliation du Solde

Activité Utilisateur

​Bonnes Pratiques

​Endpoints Associés

Obtenir le Solde

Vue d’Ensemble

Paramètres de Requête

Types de Transaction

Entrée d’Argent (Incrément)

Sortie d’Argent (Décrément)

Réponse

Exemples

Avec Filtrage par Date

Exemple de Réponse

Cas d’Utilisation

Bonnes Pratiques

Endpoints Associés