Vérification des transactions - iPayMoney

Vérifiez un paiement côté serveur avant de livrer un produit, créditer un solde ou confirmer une commande.

Endpoint

GET /api/v1/payments/{reference}

{reference} accepte la référence interne iPayMoney ou la valeur transaction_id transmise lors de la création. Les quatre en-têtes d’authentification restent obligatoires, y compris Ipay-Payment-Type.

Réponse trouvée

{
  "public_reference": "REFERENCE_PUBLIQUE",
  "external_reference": "ORDER-001",
  "reference": "REFERENCE_IPAYMONEY",
  "status": "succeeded",
  "msisdn": "22997000000",
  "amount": 1000,
  "validated_at": "2026-06-04T13:30:00.000Z"
}

Avant de confirmer l’opération, comparez au minimum :

status avec succeeded ;
external_reference avec la commande attendue ;
amount avec le montant attendu ;
la référence avec celle stockée lors de la création.

Paiement introuvable

Une référence absente du compte authentifié retourne 404 :

{
  "message": "Payment Not Found"
}

Webhook et vérification

Le webhook réduit les interrogations répétées, mais l’endpoint de vérification reste utile pour confirmer une notification, traiter le retour d’un utilisateur ou réconcilier les opérations dont la notification n’a pas été reçue.