Lister les Transactions
curl --request GET \
--url https://api.oneclickdz.com/v3/account/transactions \
--header 'X-Access-Token: <api-key>'import requests
url = "https://api.oneclickdz.com/v3/account/transactions"
headers = {"X-Access-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://api.oneclickdz.com/v3/account/transactions")
.header("X-Access-Token", "<api-key>")
.asString();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>"
}
}Compte
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 --request GET \
--url https://api.oneclickdz.com/v3/account/transactions \
--header 'X-Access-Token: <api-key>'import requests
url = "https://api.oneclickdz.com/v3/account/transactions"
headers = {"X-Access-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://api.oneclickdz.com/v3/account/transactions")
.header("X-Access-Token", "<api-key>")
.asString();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
Afficher properties
array
requis
Tableau d’objets de transaction
Afficher transaction object
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 decrementnumber
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)
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
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.totalPagespour déterminer s’il y a d’autres données
Filtrage par Date
Filtrage par Date
- Fournissez toujours les paramètres
fromettoensemble - 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
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
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

