Skip to main content
GET
Lister les Transactions

Vue d’Ensemble

Retourne vos transactions Bill Payment, les plus récentes en premier. Utilisez-le pour la réconciliation, pour un écran d’historique, et pour retrouver une transaction lorsque vous avez perdu son identifiant et sa référence. La liste est limitée à votre propre compte et à l’environnement de la clé que vous envoyez : une clé sandbox ne voit jamais les transactions de production, et inversement.
data est un tableau simple d’objets transaction. Les compteurs se trouvent dans meta : total, limit et offset.

Paramètres de Requête

string
Filtrer par statut. L’une des valeurs PENDING, READY, PROCESSING, SUCCESS, FAILED, REFUNDED, UNKNOWN.
string
Filtrer par facturier. L’une des valeurs ADE, SONELGAZ, SEAAL, AADL, Algérie Télécom.
string
Uniquement les transactions créées à cet instant ou après. Une date ou date-heure ISO 8601, par exemple 2026-08-01 ou 2026-08-01T00:00:00Z.
string
Uniquement les transactions créées à cet instant ou avant. Même format que from.
integer
défaut:"20"
Taille de page, entre 1 et 100.
integer
défaut:"0"
Combien de transactions ignorer. Zéro ou plus.
Il n’y a pas de filtre ref sur cet endpoint. Pour retrouver une transaction par votre propre référence, utilisez Obtenir une Transaction par Référence.

Réponse

boolean
requis
true lorsque la page a été retournée.
array
requis
Un tableau d’objets transaction, les plus récents en premier. Chaque entrée a exactement la forme documentée sur Obtenir une Transaction par ID — y compris la règle selon laquelle bills, selectedBill, receiptUrl, operationId et error n’apparaissent que dans les statuts où ils ont un sens.Un tableau vide signifie qu’aucune transaction ne correspond.
object
requis
string
requis
Identifiant de corrélation, également envoyé dans l’en-tête de réponse X-Request-Id.

Exemples

Réponse de Succès

Réponses d’Erreur

Une valeur de filtre n’a pas été acceptée.
Causes courantes : un statut ou un partenaire en dehors de l’ensemble autorisé, un from ou un to qui n’est pas une date ISO 8601, un limit supérieur à 100 ou inférieur à 1, un offset négatif.Que faire : corrigez la chaîne de requête. Les valeurs sont sensibles à la casse.
La clé était absente ou a été rejetée.
Que faire : vérifiez la clé avec Valider la Clé API.
Nous n’avons pas pu vérifier votre clé à temps, ou l’API est en maintenance planifiée.
Que faire : respectez l’en-tête Retry-After (5 secondes) et réessayez. Le listage peut toujours être répété sans risque.

Parcourir une période page par page

meta.total est le nombre correspondant aux filtres que vous avez envoyés, vous pouvez donc paginer jusqu’à avoir tout vu. Gardez une taille de page modeste et une fenêtre bornée.
De nouvelles transactions sont créées pendant que vous paginez. Pour la réconciliation, bornez toujours la fenêtre avec from et to afin que l’ensemble des résultats ne puisse pas grossir sous vos pieds.

Ce que contient la liste

Les découvertes comme les paiements apparaissent ici. type les distingue :
  • type: "discovery" — une recherche qui n’a pas été payée. Son status est PENDING, READY ou FAILED.
  • type: "payment" — une découverte contre laquelle un paiement a été soumis. Son status est PROCESSING, SUCCESS, FAILED, REFUNDED ou UNKNOWN.
Une transaction devient un payment sur place, en conservant son transactionId et sa ref d’origine.

Bonnes Pratiques

Bornez chaque requête

Envoyez toujours from et to pour la réconciliation. Une liste non bornée grandit avec votre activité.

Réconciliez sur SUCCESS et REFUNDED

Ces deux statuts sont ceux où l’argent a bougé. FAILED n’en a jamais déplacé.

N'interrogez pas cet endpoint en boucle

Pour suivre une seule transaction, interrogez-la par identifiant. Lister de façon répétée est plus lent et plus lourd des deux côtés.

Lisez meta.total

C’est le nombre correspondant à vos filtres, et le seul moyen de savoir si une autre page existe.

Endpoints Associés

Obtenir une Transaction par ID

L’objet transaction complet

Obtenir une Transaction par Référence

Rechercher par votre propre ref

Télécharger le Reçu

Preuve pour une transaction payée

Reçus et Réconciliation

Une routine de réconciliation quotidienne