Lister les Partenaires

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

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

fetch('https://billapi.oneclickdz.com/v3/partners', 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://billapi.oneclickdz.com/v3/partners",
  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://billapi.oneclickdz.com/v3/partners"

	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://billapi.oneclickdz.com/v3/partners")

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": {
    "ADE": {},
    "SONELGAZ": {},
    "SEAAL": {},
    "AADL": {},
    "Algérie Télécom": {}
  },
  "status": "<string>",
  "meta": {
    "timestamp": "<string>"
  },
  "requestId": "<string>"
}

GET

partners

Lister les Partenaires

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

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

fetch('https://billapi.oneclickdz.com/v3/partners', 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://billapi.oneclickdz.com/v3/partners",
  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://billapi.oneclickdz.com/v3/partners"

	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://billapi.oneclickdz.com/v3/partners")

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": {
    "ADE": {},
    "SONELGAZ": {},
    "SEAAL": {},
    "AADL": {},
    "Algérie Télécom": {}
  },
  "status": "<string>",
  "meta": {
    "timestamp": "<string>"
  },
  "requestId": "<string>"
}

Vue d’ensemble

Retourne la disponibilité de chaque facturier pris en charge. Appelez-le avant une découverte afin de masquer un partenaire indisponible à vos clients, plutôt que de les laisser tomber sur un 503 à la fin d’un formulaire. La réponse est une table indexée par la valeur partner exacte que vous envoyez à Découvrir les Factures — accents compris dans Algérie Télécom.

Une clé PRODUCTION voit la disponibilité en temps réel. Une clé SANDBOX voit une table fixe, car une requête sandbox n’atteint jamais un partenaire et la disponibilité réelle y serait trompeuse.

Réponse

boolean

requis

true lorsque la table a été retournée.

object

requis

Une entrée par partenaire. L’ensemble des clés est fixe.

Afficher properties

object

Algérienne Des Eaux — eau.

object

Électricité et gaz.

object

Eau pour Alger et Tipaza.

object

Échéances de logement.

object

Téléphonie fixe et internet.

Chaque entrée possède un seul champ :

string

requis

ACTIVE — la découverte et le paiement sont acceptés.UNAVAILABLE — la découverte et le paiement pour ce partenaire répondent 503 PARTNER_UNAVAILABLE.

object

requis

Afficher properties

string

requis

Heure de la réponse, ISO 8601 UTC.

string

requis

Identifiant de corrélation, également envoyé dans l’en-tête de réponse X-Request-Id.

Exemples

curl https://billapi.oneclickdz.com/v3/partners \
  -H "X-Access-Token: YOUR_API_KEY"

const response = await fetch("https://billapi.oneclickdz.com/v3/partners", {
  headers: { "X-Access-Token": process.env.ONECLICKDZ_API_KEY },
});

const body = await response.json();

if (!body.success) {
  throw new Error(`${body.error.code}: ${body.error.message}`);
}

const available = Object.entries(body.data)
  .filter(([, partner]) => partner.status === "ACTIVE")
  .map(([name]) => name);

console.log(available);

import os
import requests

response = requests.get(
    'https://billapi.oneclickdz.com/v3/partners',
    headers={'X-Access-Token': os.getenv('ONECLICKDZ_API_KEY')}
)

body = response.json()

if not body['success']:
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")

available = [
    name for name, partner in body['data'].items()
    if partner['status'] == 'ACTIVE'
]

print(available)

<?php
$ch = curl_init('https://billapi.oneclickdz.com/v3/partners');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-Access-Token: ' . getenv('ONECLICKDZ_API_KEY')
]);

$body = json_decode(curl_exec($ch), true);
curl_close($ch);

if (!$body['success']) {
    throw new Exception($body['error']['code'] . ': ' . $body['error']['message']);
}

$available = array_keys(array_filter(
    $body['data'],
    fn($partner) => $partner['status'] === 'ACTIVE'
));

print_r($available);
?>

Réponse de succès

{
  "success": true,
  "data": {
    "ADE": { "status": "ACTIVE" },
    "SONELGAZ": { "status": "ACTIVE" },
    "SEAAL": { "status": "UNAVAILABLE" },
    "AADL": { "status": "UNAVAILABLE" },
    "Algérie Télécom": { "status": "ACTIVE" }
  },
  "meta": {
    "timestamp": "2026-08-31T10:15:32.194Z"
  },
  "requestId": "req_9f3a1c72e0b84d51aB3xZq07"
}

Réponses d’erreur

401 — Token d'Accès Manquant

L’en-tête X-Access-Token n’a pas été envoyé.

{
  "success": false,
  "error": {
    "code": "MISSING_ACCESS_TOKEN",
    "message": "X-Access-Token header is required."
  },
  "requestId": "req_9f3a1c72e0b84d51aB3xZq07"
}

Que faire : ajoutez l’en-tête et réessayez.

401 — Token d'Accès Invalide

La clé a été rejetée.

{
  "success": false,
  "error": {
    "code": "INVALID_ACCESS_TOKEN",
    "message": "The provided access token is invalid."
  },
  "requestId": "req_9f3a1c72e0b84d51aB3xZq07"
}

Que faire : vérifiez la clé avec Valider la Clé API.

503 — Authentification Indisponible

Nous n’avons pas pu vérifier votre clé à temps.

{
  "success": false,
  "error": {
    "code": "AUTH_UNAVAILABLE",
    "message": "Authentication is temporarily unavailable. Please retry shortly."
  },
  "requestId": "req_9f3a1c72e0b84d51aB3xZq07"
}

Que faire : réessayez après le délai de l’en-tête Retry-After. Servez entre-temps la dernière table mise en cache.

503 — Service Indisponible

L’API Bill Payment est en maintenance planifiée.

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "The service is temporarily unavailable. Please retry shortly."
  },
  "requestId": "req_9f3a1c72e0b84d51aB3xZq07"
}

Que faire : respectez Retry-After et réessayez.

Disponibilité actuelle

SEAAL et AADL sont actuellement UNAVAILABLE aussi bien en sandbox qu’en production, et toute découverte ou tout paiement les concernant répond 503 PARTNER_UNAVAILABLE. Il s’agit du réglage actuel de l’opérateur, et non d’une limitation permanente — gardez les deux partenaires dans votre code et laissez cet endpoint décider de ce qu’il faut afficher.

Ne codez en dur la disponibilité d’aucun partenaire. Lisez cette table, et traitez un 503 PARTNER_UNAVAILABLE lors d’une découverte comme un partenaire devenu indisponible entre votre dernier rafraîchissement et la requête.

Mettre la table en cache

La disponibilité change rarement. Rafraîchissez-la sur une minuterie plutôt qu’avant chaque découverte, et continuez à servir la dernière copie valide lorsqu’un rafraîchissement échoue.

let cache = { map: null, fetchedAt: 0 };
const TTL_MS = 5 * 60 * 1000;

async function getPartners() {
  if (cache.map && Date.now() - cache.fetchedAt < TTL_MS) {
    return cache.map;
  }

  try {
    const response = await fetch("https://billapi.oneclickdz.com/v3/partners", {
      headers: { "X-Access-Token": process.env.ONECLICKDZ_API_KEY },
    });

    const body = await response.json();

    if (body.success) {
      cache = { map: body.data, fetchedAt: Date.now() };
    }
  } catch (error) {
    // Keep serving the previous map rather than blocking the customer.
  }

  return cache.map ?? {};
}

async function isAvailable(partner) {
  const map = await getPartners();
  return map[partner]?.status === "ACTIVE";
}

Bonnes pratiques

Mettre en Cache Quelques Minutes

Un cache de 5 minutes suffit. Appeler cet endpoint avant chaque découverte ajoute un aller-retour et n’apporte rien.

Échouer en Douceur au Rafraîchissement

Si le rafraîchissement échoue, conservez la table précédente. Une liste de partenaires vide est pire qu’une liste légèrement périmée.

Utiliser la Valeur Exacte du Partenaire

Envoyez Algérie Télécom avec ses accents. La valeur est la clé de cette table, caractère pour caractère.

Gérer la Situation de Concurrence

Un partenaire peut devenir indisponible après sa mise en cache. Gérez aussi 503 PARTNER_UNAVAILABLE lors de la découverte.

Endpoints associés

Valider la Clé API

Confirmez votre clé et votre environnement

Découvrir les Factures

Consultez ce qu’un compte doit

Partenaires et Comptes

Identifiants de chaque partenaire

Vue d'ensemble Bill Payment

Comment tout le flux s’articule

Référence API

Core

Compte

Recharges mobiles

Recharges internet

Cartes cadeaux

Navio

Paiement de factures

Lister les Partenaires

Vue d’ensemble

Réponse

Exemples

Réponse de succès

Réponses d’erreur

Disponibilité actuelle

Mettre la table en cache

Bonnes pratiques

Mettre en Cache Quelques Minutes

Échouer en Douceur au Rafraîchissement

Utiliser la Valeur Exacte du Partenaire

Gérer la Situation de Concurrence

Endpoints associés

Valider la Clé API

Découvrir les Factures

Partenaires et Comptes

Vue d'ensemble Bill Payment

​Vue d’ensemble

​Réponse

​Exemples

​Réponse de succès

​Réponses d’erreur

​Disponibilité actuelle

​Mettre la table en cache

​Bonnes pratiques

Mettre en Cache Quelques Minutes

Échouer en Douceur au Rafraîchissement

Utiliser la Valeur Exacte du Partenaire

Gérer la Situation de Concurrence

​Endpoints associés

Valider la Clé API

Découvrir les Factures

Partenaires et Comptes

Vue d'ensemble Bill Payment

Vue d’ensemble

Réponse

Exemples

Réponse de succès

Réponses d’erreur

Disponibilité actuelle

Mettre la table en cache

Bonnes pratiques

Endpoints associés