> ## Documentation Index
> Fetch the complete documentation index at: https://docs.i-pay.money/llms.txt
> Use this file to discover all available pages before exploring further.

# Vérification des transactions

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

## Endpoint

```http theme={null}
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

```json theme={null}
{
  "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` :

```json theme={null}
{
  "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.