Partenaires et comptes - OneClickDz Flexy API

Disponibilité

GET /v3/bills/partners renvoie une entrée par facturier avec un unique status : ACTIVE ou UNAVAILABLE.

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

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

Un facturier UNAVAILABLE répond 503 PARTNER_UNAVAILABLE sur discover et pay. Lisez cette table lorsque vous construisez votre sélecteur de facturiers et masquez ceux qui sont indisponibles ; la disponibilité change sans préavis.

Une clé de production voit la disponibilité réelle. Une clé sandbox voit tous les facturiers ACTIVE, car les requêtes sandbox n’atteignent jamais un facturier.

Le nom du partenaire

partner est la clé exacte de la table ci-dessus. Algérie Télécom s’écrit avec ses accents et une espace ; toute autre orthographe est rejetée avec 400 ERR_VALIDATION.

L’objet account

account contient exactement un identifiant, et cet identifiant doit être celui que le facturier comprend. Le tableau ci-dessous en donne la liste complète.

Partenaire	`account`	Où le client le trouve
`ADE`	`{ "electronic_payment_key": "…" }`	Clé de paiement électronique sur la facture d’eau, 25 caractères
`SONELGAZ`	`{ "sonelgaz": { "invoice_number", "amount_without_stamp", "ebb_key" } }`	Numéro de facture, montant hors timbre et clé EBB sur la facture d’électricité/gaz
`SEAAL`	`{ "seaal": { "code_client", "code_contrat" } }`	Code client et code contrat sur la facture d’eau SEAAL
`AADL`	`{ "aadl": { "codeloc" } }`	Code logement du dossier de logement AADL
`SEOR`	`{ "seor": { "contrat", "facture" } }`	N° Contrat et N° Facture sur la facture d’eau SEOR
`Algérie Télécom`	`{ "phone_number": "…" }`	Le numéro de téléphone fixe

ADE

{
  "partner": "ADE",
  "account": { "electronic_payment_key": "0123456789012345678901234" },
  "ref": "disc-20260920-0001"
}

electronic_payment_key compte exactement 25 caractères. Chaque clé identifie une facture.

SONELGAZ

{
  "partner": "SONELGAZ",
  "account": {
    "sonelgaz": {
      "invoice_number": "313260119713",
      "amount_without_stamp": "28491.72",
      "ebb_key": "169"
    }
  },
  "ref": "disc-20260920-0002"
}

Les trois champs sont des chaînes obligatoires, recopiées telles qu’imprimées sur la facture. amount_without_stamp est le montant avant timbre fiscal, avec un point comme séparateur décimal. Le facturier valide les trois valeurs ensemble ; une incohérence termine la découverte avec INVALID_ACCOUNT.

SEAAL

{
  "partner": "SEAAL",
  "account": { "seaal": { "code_client": "100001", "code_contrat": "446563" } },
  "ref": "disc-20260920-0003"
}

code_client compte 2 à 6 caractères alphanumériques, code_contrat 2 à 10 chiffres. Les deux sont obligatoires. Un compte SEAAL peut comporter plusieurs factures trimestrielles impayées ; la découverte les renvoie toutes.

AADL

{
  "partner": "AADL",
  "account": { "aadl": { "codeloc": "1112223334" } },
  "ref": "disc-20260920-0004"
}

codeloc compte 6 à 20 chiffres. AADL émet un avis agrégé par dossier de logement. Les arriérés sont inclus dans ce montant unique et ne peuvent pas être payés séparément.

SEOR

{
  "partner": "SEOR",
  "account": { "seor": { "contrat": "100001", "facture": "00102026S000000001" } },
  "ref": "disc-20260920-0006"
}

contrat compte 1 à 6 chiffres ; la facture l’imprime avec un espace (284 932) et les espaces sont ignorés. facture compte 18 lettres ou chiffres. Les deux sont obligatoires. SEOR (eau d’Oran) est mono-facture : la découverte renvoie exactement la facture envoyée. SEOR ne distingue pas une paire erronée d’une facture déjà réglée en agence ; pour SEOR, INVALID_ACCOUNT signifie donc « informations invalides ou facture déjà réglée ».

Algérie Télécom

{
  "partner": "Algérie Télécom",
  "account": { "phone_number": "023456789" },
  "ref": "disc-20260920-0005"
}

phone_number est un numéro fixe à 9 chiffres : 0, puis 2, 3 ou 4, puis 7 chiffres. Les numéros mobiles ne sont pas acceptés.

Ce que l’API renvoie

Chaque transaction renvoie l’identifiant sous account, à plat, avec une clé qui dépend du partenaire :

Partenaire	`account` dans les réponses
`ADE`	`{ "reference": "<electronic_payment_key>" }`
`SONELGAZ`	`{ "contractNumber": "<invoice_number>" }`
`SEAAL`	`{ "codeClient": "<code_client>" }`
`AADL`	`{ "codeloc": "<codeloc>" }`
`SEOR`	`{ "facture": "<facture>" }`
`Algérie Télécom`	`{ "phoneNumber": "<phone_number>" }`

Ces clés sont uniquement en sortie. Utilisez les formats de requête ci-dessus lors de l’envoi.

Les intégrations réalisées avant cette page envoient reference (ADE) ou phoneNumber (Algérie Télécom) comme identifiant. Les deux restent acceptés et sont convertis en electronic_payment_key et phone_number ; les nouvelles intégrations doivent utiliser les formats ci-dessus.

Erreurs de validation

Erreur	HTTP	Cause
`ERR_VALIDATION`	400	Partenaire inconnu, champ manquant, format incorrect ou plusieurs identifiants. `details` liste chaque problème.
`INVALID_ACCOUNT`	400	Sandbox uniquement : les comptes de test invalides répondent immédiatement. En production, un identifiant rejeté apparaît sur la transaction.

Une 400 ne crée jamais de transaction. Lorsque l’identifiant est bien formé mais que le facturier ne le reconnaît pas, la découverte est acceptée puis se termine FAILED avec error.code = INVALID_ACCOUNT (voir Découverte des factures).

Suivant : Découverte des factures

Lancer une découverte et lire les factures

​Disponibilité

​Le nom du partenaire

​L’objet account

​ADE

​SONELGAZ

​SEAAL

​AADL

​SEOR

​Algérie Télécom

​Ce que l’API renvoie

​Erreurs de validation

Suivant : Découverte des factures

Disponibilité

Le nom du partenaire

L’objet account

ADE

SONELGAZ

SEAAL

AADL

SEOR

Algérie Télécom

Ce que l’API renvoie

Erreurs de validation