Skip to main content
GET
Consulter une transaction
Utilisez cette opération pour connaître le statut réel d’une transaction, plutôt que de vous fier au statut renvoyé à la création. C’est elle (ou un webhook) qui doit déclencher la livraison d’une commande, jamais la réponse de Créer une transaction.
  • Référence. Elle accepte deux valeurs interchangeables : la référence interne renvoyée à la création, ou votre propre transaction_id (retrouvé sous le nom external_reference). Inutile de conserver les deux si vous ne gardez que transaction_id côté marchand.
  • Statut. Une transaction pending peut encore devenir succeeded, failed ou refunded. Attendez un statut définitif (ou un webhook) avant de considérer la vérification terminée.
  • Référence inconnue. Une référence qui ne correspond à aucune transaction du compte authentifié renvoie 404, y compris si elle existe pour un autre compte ou un autre environnement (Sandbox/Live).
La liste complète des messages d’erreur communs est dans 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"

Path Parameters

reference
string
required

Response

Transaction trouvée pour le compte authentifié

public_reference
string
required
external_reference
string
required
reference
string
required
status
enum<string>
required
Available options:
initiated,
pending,
succeeded,
failed,
refunded
msisdn
string
required
amount
integer
required
validated_at
string<date-time> | null