Tests en sandbox - OneClickDz Flexy API

Fonctionnement de la sandbox

Une clé sandbox utilise la même URL de base, les mêmes routes, la même enveloppe, les mêmes statuts et la même interrogation que la production. Les différences :

Aucun facturier n’est contacté et aucun argent ne circule.
Le résultat est déterminé par l’identifiant de compte que vous envoyez (tableaux ci-dessous). Tout autre identifiant renvoie une facture de 500.00 DZD et un paiement réussi.
La découverte se termine en environ 0,2 s et le paiement en environ 0,5 s ; votre logique d’interrogation doit donc quand même gérer PENDING et PROCESSING.
GET /v3/bills/partners indique tous les facturiers ACTIVE.
Les reçus sont des images PNG.
Les transactions sandbox et production sont totalement séparées. Une clé sandbox ne voit jamais une transaction de production, et inversement.

Vérifiez à quel environnement appartient une clé avec Validate Access Token.

Comptes de test

ADE

account: { "electronic_payment_key": "<value>" }

`electronic_payment_key`	Découverte	Paiement
`0123456789012345678901234`	1 facture, 443.39 DZD	`SUCCESS`
`0123456789012340000000001`	1 facture, 320.00 DZD	`SUCCESS`
`0123456789012340000000002`	`READY`, `bills: []`	—
`0123456789012341111111111`	`READY`, `bills: []`	—
`0123456789012340000000004`	1 facture, 400.00 DZD	`FAILED`, `PAYMENT_DECLINED`
`0123456789012340000000005`	1 facture, 550.00 DZD	`REFUNDED`, `PAYMENT_DECLINED`
`0001234567890000000000000`	1 facture, 600.00 DZD	`REFUNDED`, `PAYMENT_DECLINED`
`0123456789012340000000006`	`409 BILL_ALREADY_PAID`	—
`0123456789012347777777777`	`409 BILL_ALREADY_PAID`	—
`0123456789012345005005005`	`503 PARTNER_UNAVAILABLE`	—
`abc0000000000000000000000`	`400 INVALID_ACCOUNT`	—

SONELGAZ

account: { "sonelgaz": { "invoice_number": "<value>", "amount_without_stamp": "1200.00", "ebb_key": "123456" } } — le résultat dépend de invoice_number ; les deux autres champs doivent seulement être présents.

`invoice_number`	Découverte	Paiement
`9876543210`	2 factures, 1200.00 et 850.00 DZD	`SUCCESS`
`4004004004`	1 facture, 500.00 DZD	`FAILED`, `PAYMENT_DECLINED`
`6006006006`	1 facture, 900.00 DZD	`UNKNOWN` pendant environ 60 s, puis `REFUNDED`
`0000000003`	`READY`, `bills: []`	—

SEAAL

account: { "seaal": { "code_client": "<value>", "code_contrat": "446563" } } — le résultat dépend de code_client ; code_contrat doit seulement compter 2 à 10 chiffres.

`code_client`	Découverte	Paiement
`100001`	5 factures trimestrielles (456.33 × 3, 327.00 × 2)	`SUCCESS` (testez `billIds` ici)
`100002`	1 facture, 512.75 DZD	`SUCCESS`
`100003`	`FAILED`, `BILL_ALREADY_PAID`	—
`100004`	1 facture, 389.10 DZD	`FAILED`, `PAYMENT_DECLINED`
`100005`	`FAILED`, `INVALID_ACCOUNT`	—

AADL

account: { "aadl": { "codeloc": "<value>" } }

`codeloc`	Découverte	Paiement
`1112223334`	1 avis, 5400.00 DZD, avec `breakdown`	`SUCCESS`
`2223334445`	1 avis, 12000.00 DZD, avec `breakdown` indiquant 2 périodes impayées	`SUCCESS`
`3334445556`	`READY`, `bills: []`	—
`4445556667`	`FAILED`, `BILL_ALREADY_PAID`	—

L’endpoint de l’avis AADL (/avis) n’est pas disponible en sandbox.

SEOR

account: { "seor": { "contrat": "100001", "facture": "<value>" } } — le résultat dépend de facture ; contrat doit seulement compter 1 à 6 chiffres.

`facture`	Découverte	Paiement
`00102026S000000001`	1 facture, 1003.20 DZD, période `2/2026`	`SUCCESS`
`00102026S000000002`	`FAILED`, `BILL_ALREADY_PAID`	—
`00102026S000000003`	`FAILED`, `INVALID_ACCOUNT`	—
`00102026S000000004`	1 facture, 850.40 DZD	`UNKNOWN`, jamais remboursé automatiquement

Algérie Télécom

account: { "phone_number": "<value>" }

`phone_number`	Découverte	Paiement
`023456789`	1 facture, 300.00 DZD	`SUCCESS`

Erreurs que vous pouvez déclencher

Comment	Résultat
Omettre l’en-tête `X-Access-Token`	`401 MISSING_ACCESS_TOKEN`
Envoyer une clé erronée	`401 INVALID_ACCESS_TOKEN`
Envoyer deux fois la même `ref` à `discover` pour le même partenaire	`403 DUPLICATED_REF`
Envoyer deux identifiants dans `account`	`400 ERR_VALIDATION`
Réutiliser la `ref` de découverte sur `pay`	`403 DUPLICATED_REF`
Payer une transaction qui n’est pas `READY` (encore `PENDING`, ou déjà payée)	`404 NOT_FOUND`
Payer avec un `billId` absent de `bills[]` de la transaction	`404 NOT_FOUND`

Un parcours sandbox complet

# 1. Discover
curl -X POST https://api.oneclickdz.com/v3/bills/discover \
  -H "X-Access-Token: $ONECLICKDZ_SANDBOX_API_KEY" -H "Content-Type: application/json" \
  -d '{"partner":"SONELGAZ","account":{"sonelgaz":{"invoice_number":"9876543210","amount_without_stamp":"1200.00","ebb_key":"123456"}},"ref":"test-0001"}'

# 2. Read the bills (repeat until READY)
curl https://api.oneclickdz.com/v3/bills/transactions/{transactionId} \
  -H "X-Access-Token: $ONECLICKDZ_SANDBOX_API_KEY"

# 3. Pay one of the bills
curl -X POST https://api.oneclickdz.com/v3/bills/pay \
  -H "X-Access-Token: $ONECLICKDZ_SANDBOX_API_KEY" -H "Content-Type: application/json" \
  -d '{"transactionId":"{transactionId}","billId":"{billId}","ref":"test-0001-pay"}'

# 4. Confirm (repeat until SUCCESS / FAILED / REFUNDED)
curl https://api.oneclickdz.com/v3/bills/transactions/{transactionId} \
  -H "X-Access-Token: $ONECLICKDZ_SANDBOX_API_KEY"

# 5. Receipt
curl https://api.oneclickdz.com/v3/bills/transactions/{transactionId}/receipt \
  -H "X-Access-Token: $ONECLICKDZ_SANDBOX_API_KEY" --output receipt.png

Avant de passer en production

Votre logique d’interrogation gère chaque statut, y compris UNKNOWN (SONELGAZ 6006006006).
Un paiement FAILED ou REFUNDED ne laisse aucun débit à votre client.
Une 409, une 403 ou une expiration ne déclenche jamais un second pay.
Chaque pay utilise une nouvelle ref.
Les commandes multi-factures affichent correctement selectedBills (SEAAL 100001).
Les reçus sont conservés avec operationId.
La clé de production est chargée depuis la configuration, jamais depuis le code.

​Fonctionnement de la sandbox

​Comptes de test

​ADE

​SONELGAZ

​SEAAL

​AADL

​SEOR

​Algérie Télécom

​Erreurs que vous pouvez déclencher

​Un parcours sandbox complet

​Avant de passer en production