Lister les Transactions
Paiement de factures
Lister les Transactions
Parcourir vos découvertes et paiements de factures page par page
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.
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
400 — Erreur de validation
400 — Erreur de validation
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.401 — Jeton d'accès manquant ou invalide
401 — Jeton d'accès manquant ou invalide
503 — Authentification ou service indisponible
503 — Authentification ou service indisponible
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. SonstatusestPENDING,READYouFAILED.type: "payment"— une découverte contre laquelle un paiement a été soumis. SonstatusestPROCESSING,SUCCESS,FAILED,REFUNDEDouUNKNOWN.
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
refTélécharger le Reçu
Preuve pour une transaction payée
Reçus et Réconciliation
Une routine de réconciliation quotidienne

