Aller au contenu principal

Statut & redirection

Le statut d'un paiement fait autorité côté serveur. Ces endpoints vous permettent de lire l'état réel et de gérer le retour du client.

Lire un paiement​

GET /partners/payments/{paymentRequestId}

Requiert le scope payments:read.

En-têteRequisValeur
AuthorizationOuiBearer <access_token>

Exemple​

GET /partners/payments/6f1a2b3c4d5e67890123456789abcdef
Authorization: Bearer <access_token>

Réponse​

{
  "paymentRequestId": "6f1a2b3c4d5e67890123456789abcdef",
  "externalReference": "ORDER-123",
  "amount": 150.0,
  "currency": "EUR",
  "status": "CREATED",
  "transactionId": "TRX-123",
  "orderId": "ORDER-ID-123",
  "stateId": "STATE-001",
  "paymentUrl": "https://gateway.lodinpay.com/pay?id=ORDER-ID-123&type=PARTNER&canal=WEB",
  "callbackUri": "https://partner.example.com/callback",
  "webhookUri": "https://partner.example.com/api/payment/webhook",
  "createdAt": "2026-06-10T12:00:00Z",
  "updatedAt": "2026-06-10T12:00:00Z"
}

Un paymentRequestId introuvable renvoie 404 (Payment not found).

Suivi du statut

Tant que la livraison par webhook n'est pas active, interrogez cet endpoint pour suivre l'évolution du status (voir le cycle de vie).

Retour navigateur du client​

GET /partners/payments/{paymentRequestId}/redirect

À la fin du parcours, dirigez le navigateur du client vers cet endpoint. Il répond par une redirection 302 Found vers votre callbackUri, en ajoutant paymentRequestId (puis stateId s'il existe) en paramètres de requête.

Cet endpoint ne modifie pas l'état du paiement et ignore les paramètres de requête transmis par le navigateur ou le fournisseur : il n'est pas une source de vérité.

Résoudre l'URL de retour (prévisualisation)​

POST /partners/payments/{paymentRequestId}/resolve-redirect

Renvoie l'URL de retour qui serait utilisée, sans effectuer la redirection. Le corps est optionnel (status, transactionId, errorCode, errorMessage) et n'est pas persisté — l'endpoint est en lecture seule (prévisualisation).

Réponse​

{
  "redirectUrl": "https://partner.example.com/callback?paymentRequestId=6f1a2b3c4d5e67890123456789abcdef&stateId=STATE-001"
}