Suivre l'état d'une demande de contrat
GET /api/v1/payments/dexpay/:reference — récupérer le statut métier d'une demande partenaire.
But
Consulter l'état courant d'une demande de contrat créée via l'endpoint partenaire.
La section ci-dessous est branchée sur la spec OpenAPI réelle. Elle expose les paramètres, les schémas de réponse et le playground d'exécution.
Résumé rapide
- Méthode:
GET - Route:
/api/v1/payments/dexpay/{reference} - Clé utile:
reference - Usage: suivi front, réconciliation, fallback si webhook manqué
Quand utiliser cet endpoint
Cette route est utile dans trois cas:
- verifier l etat d une demande juste apres redirection paiement,
- corriger un webhook manque ou arrive trop tard,
- permettre a un back-office partenaire de relire la situation exacte d un dossier.
Statuts métier
contractStatus | Signification |
|---|---|
PENDING_PAYMENT | En attente de paiement. |
PAYMENT_FAILED | Paiement annulé/en échec. |
ISSUANCE_IN_PROGRESS | Paiement validé, émission en cours. |
ACTIVE | Contrat émis. |
ISSUANCE_FAILED | Paiement validé mais émission échouée. |
REFUNDED | Paiement remboursé. |
ISSUANCE_FAILED est un cas critique: le client a paye mais aucun contrat n est
encore emis. Branche un alerting immediat et remonte l information au support.
Bonnes pratiques
- Interroger cette route avec la
referencestockee lors de la creation. - Ne pas poller agressivement: prefere une relecture ponctuelle ou un fallback apres webhook manque.
- Conserver le dernier
contractStatusconnu dans ta base pour simplifier l UX partenaire.
Référence interactive
curl -X GET "http://localhost:3210/api/v1/payments/dexpay/AUTO_CLASSIC_1712345678901_ab12cd34ef56"Voir aussi
Comprendre le parcours complet de la demande au contrat actif.
Tester les endpoints et consulter les schemas OpenAPI reels.
Verifier la signature et traiter les emissions en temps reel.
Valider les prerequis de production avant ouverture partenaire.