Webhooks
La livraison des webhooks partenaires n'est pas encore active, quelle que soit la méthode. Vous fournissez déjà l'URL à la création (webhookUri en méthode OAuth, webhookUrl en méthode HMAC) et elle est enregistrée, mais aucune notification n'est encore émise. En attendant, suivez le statut en interrogeant Lire un paiement (OAuth).
Principe prévu
Lorsqu'un paiement change d'état, LodinPay enverra une requête signée à le webhookUri que vous avez fourni à la création. Le webhook sera la voie recommandée pour recevoir les confirmations de paiement de manière fiable, sans interrogation périodique.
Charge utile prévue
Le contrat de charge utile envisagé contient les champs suivants :
| Champ | Type | Description |
|---|---|---|
paymentRequestId | String | Identifiant du paiement. |
externalReference | String | Votre référence. |
status | String | Nouvel état (voir le cycle de vie). |
transactionId | String | Identifiant de transaction. |
amount | Double | Montant. |
currency | String | Devise (EUR). |
occurredAt | Instant | Horodatage de l'événement. |
Exemple (non contractuel, la livraison n'étant pas encore active) :
{
"paymentRequestId": "6f1a2b3c4d5e67890123456789abcdef",
"externalReference": "ORDER-123",
"status": "SUCCESS",
"transactionId": "TRX-123",
"amount": 150.0,
"currency": "EUR",
"occurredAt": "2026-06-10T12:00:00Z"
}
La signature de vérification, les en-têtes, le contrat de codes de réponse, l'idempotence et les relances seront précisés lorsque la livraison sera disponible. Contactez l'équipe intégrations pour être averti.