Skip to main content

​
What it does

Bill Payment lets your application pay Algerian bills on behalf of your customers. You send a customer’s account identifier, the API returns the unpaid bills, you pay one or more of them, and you download the receipt. Six billers are supported: ADE, SONELGAZ, SEAAL, AADL, SEOR and Algérie Télécom.
Base URL: https://api.oneclickdz.com. Every request carries your key in the X-Access-Token header. A sandbox key and a production key use the same URL and the same routes; the key decides the environment.

​
The flow

1

Discover

POST /v3/bills/discover with the partner, the account identifier and your ref. The response contains a transactionId. → Discovering bills
2

Read the bills

Poll GET /v3/bills/transactions/{id} until status is READY. The transaction now carries bills[], each with amount and fee.
3

Pay

POST /v3/bills/pay with the transactionId, one billId (or several billIds) and a new ref. → Paying bills
4

Confirm and download the receipt

Poll until status is SUCCESS, FAILED or REFUNDED, then download the receipt. → Transaction status · Receipts

​
Two rules

200 means accepted, not done. discover and pay answer immediately; the outcome is only known from the transaction’s status. Always poll.
Never resend a payment. If a call times out or returns an error you do not understand, look the transaction up by ref or by transactionId before doing anything else.

​
Statuses

​
Fees

​
Endpoints

​
Guides

1. Partners and accounts

The exact account object for each biller

2. Discovering bills

Start a discovery and read the bills

3. Paying bills

Pay one bill or several as one order

4. Transaction status

Every status, every field, how to poll

5. Receipts and reconciliation

Receipts, AADL notices and history

6. Sandbox testing

Test accounts for every outcome