Skip to main content

​
Ce que fait l’API

Le Paiement de Factures permet à votre application de payer des factures algériennes pour le compte de vos clients. Vous envoyez l’identifiant de compte d’un client, l’API renvoie les factures impayées, vous en payez une ou plusieurs, puis vous téléchargez le reçu. Six facturiers sont pris en charge : ADE, SONELGAZ, SEAAL, AADL, SEOR et Algérie Télécom.
URL de base : https://api.oneclickdz.com. Chaque requête transmet votre clé dans l’en-tête X-Access-Token. Une clé sandbox et une clé de production utilisent la même URL et les mêmes routes ; c’est la clé qui détermine l’environnement.

​
Le flux

1

Découvrir

POST /v3/bills/discover avec le partenaire, l’identifiant de compte et votre ref. La réponse contient un transactionId. → Découverte des factures
2

Lire les factures

Interrogez GET /v3/bills/transactions/{id} jusqu’à ce que status soit READY. La transaction contient alors bills[], chacune avec amount et fee.
3

Payer

POST /v3/bills/pay avec le transactionId, un billId (ou plusieurs billIds) et une nouvelle ref. → Paiement des factures
4

Confirmer et télécharger le reçu

Interrogez jusqu’à ce que status soit SUCCESS, FAILED ou REFUNDED, puis téléchargez le reçu. → Statut de la transaction · Reçus

​
Deux règles

200 signifie accepté, pas terminé. discover et pay répondent immédiatement ; le résultat n’est connu que par le status de la transaction. Interrogez toujours.
Ne renvoyez jamais un paiement. Si un appel expire ou renvoie une erreur que vous ne comprenez pas, recherchez la transaction par ref ou par transactionId avant toute autre action.

​
Statuts

​
Frais

​
Endpoints

​
Guides

1. Partenaires et comptes

L’objet account exact pour chaque facturier

2. Découverte des factures

Lancer une découverte et lire les factures

3. Paiement des factures

Payer une facture ou plusieurs en une seule commande

4. Statut de la transaction

Chaque statut, chaque champ, comment interroger

5. Reçus et rapprochement

Reçus, avis AADL et historique

6. Tests en sandbox

Comptes de test pour chaque résultat