Référence API
Vérifier un paiement
Vérifier l'état de la transaction et synchroniser le statut local.
GET /api/payments/verify/{transactionReference}Accès : Public
Cas d'usage opérateur
Après lancement d'un paiement, faire un polling toutes les 5 secondes jusqu'au statut final.
Paramètres
- transactionReference (path, obligatoire)
Le paramètre peut être la référence marchande retournée par l’achat invité ou la référence de transaction comprise par le fournisseur de paiement.
Corps de réponse
{
"message": "Payment status successfully verified",
"status": "complete",
"transactionId": "GR-TX-XXXXXXXXXX",
"targetType": "payment"
}| Attribut | Type | Description |
|---|---|---|
message | string | Résultat de la vérification. |
status | string | État de la transaction : pending, processing, complete, failed, canceled, expired, abandoned ou refunded. |
transactionId | string | Référence de transaction retournée. |
targetType | string | Type de cible synchronisée, généralement payment. |
Le portail peut effectuer un polling toutes les 5 secondes jusqu’à l’obtention d’un état final. Une transaction déjà finalisée n’est pas réouverte par cet endpoint.
Codes de statut
- 200 OK
- 404 Not Found