Aller au contenu
ReadyZone Docs
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"
}
AttributTypeDescription
messagestringRésultat de la vérification.
statusstringÉtat de la transaction : pending, processing, complete, failed, canceled, expired, abandoned ou refunded.
transactionIdstringRéférence de transaction retournée.
targetTypestringType 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

Sur cette page