Skip to main content
GET
Lister les transactions
Utile pour une vue d’ensemble ou une réconciliation périodique. Pour vérifier une transaction précise que vous venez de créer, préférez Consulter une transaction, plus direct et qui accepte votre propre transaction_id.
  • Filtres. query filtre en texte libre ; les autres paramètres filtrent sur une valeur exacte ou une plage de dates. Ils s’appliquent tous en même temps (ET logique), pas en alternative. L’exemple n’illustre qu’un sous-ensemble : ajoutez ou retirez des paramètres selon vos besoins.
  • Valeurs affichées. Les valeurs de status et payment_method (voir les moyens de paiement) sont mises en forme pour l’affichage et ne correspondent pas aux valeurs machine utilisées par les autres opérations : ne les comparez pas dans votre code, n’utilisez cette liste que pour de l’affichage ou de l’export.
  • Limites. Aucune limite de débit n’est documentée : à confirmer auprès du support avant un usage intensif. Pour un suivi en temps réel d’une transaction donnée, préférez les webhooks à un sondage répété de cette liste.
Messages d’erreur communs : Erreurs.

Authorizations

Authorization
string
header
required

Clé secrète du compte Sandbox ou Live

Headers

Content-Type
string
required

Exigé par l'authentification de l'API, y compris sur les requêtes GET qui n'ont pourtant pas de corps.

Allowed value: "application/json"
Ipay-Target-Environment
enum<string>
required
Available options:
sandbox,
live
Ipay-Payment-Type
string
required

Méthode de paiement. POST /payments ne prend en charge que mobile (mobile money). Les autres moyens de paiement (carte bancaire et autres canaux) ne s'utilisent pas ici : ils sont disponibles via les liens de paiement (POST /external_payments). Liste complète : moyens de paiement.

Allowed value: "mobile"
Example:

"mobile"

Query Parameters

query
string
status
enum<string>
Available options:
initiated,
pending,
succeeded,
failed,
refunded
created_from
string<date>
created_to
string<date>
items
integer
default:25
Required range: x >= 1

Response

Liste des transactions (tableau JSON brut, sans enveloppe de pagination). Les valeurs de status et de payment_method y sont formatées pour l'affichage (ex. Succeeded, Airtel Ne) et non normalisées : ne pas les comparer aux valeurs de statut utilisées par les autres opérations.

id
integer
reference
string
status
string
Example:

"Succeeded"

amount
integer
fees
integer
payment_method
string

Moyen de paiement utilisé par le client — voir la liste des moyens de paiement.

Example:

"Airtel Ne"

net_amount
integer
platform
string
device
string
failure_reason
string | null
country
string
currency
string
external_reference
string
msisdn
string
customer_name
string
created_at
string<date-time>
validated_at
string<date-time> | null