Catalogue des événements plateforme
Ormuz expose actuellement 148 événements plateforme canoniques. Tous peuvent être livrés par webhook ; la plupart peuvent aussi démarrer un processus. Utilisez le catalogue ci-dessous pour choisir les événements à suivre et consulter leurs données.
Structure d’un événement
Un événement possède une enveloppe commune. Son payload dépend ensuite du contrat du type d’événement : il peut contenir un objet plateforme, un snapshot, une projection ou un résultat métier enrichi.
JSON
{7 items
"id":"evt_0123456789abcdef0123456789abcdef"
"type":"invoice.issued"
"merchant_id":"mer_0123456789abcdef0123456789abcdef"
"party_id":"pty_0123456789abcdef0123456789abcdef"
"occurred_at":"2026-09-13T08:30:00.000Z"
"context":{2 items
"source":"api"
"emitted_at":"2026-09-13T08:30:00.000Z"
}
"payload":{3 items
"id":"inv_0123456789abcdef0123456789abcdef"
"object":"invoice"
"status":"issued"
}
}
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "invoice.issued",
"merchant_id": "mer_0123456789abcdef0123456789abcdef",
"party_id": "pty_0123456789abcdef0123456789abcdef",
"occurred_at": "2026-09-13T08:30:00.000Z",
"context": {
"source": "api",
"emitted_at": "2026-09-13T08:30:00.000Z"
},
"payload": {
"id": "inv_0123456789abcdef0123456789abcdef",
"object": "invoice",
"status": "issued"
}
}| Champ | Contrat |
|---|---|
id | Identifiant unique de l’occurrence, préfixé evt_. |
type | Type canonique de l’événement, par exemple invoice.issued. |
merchant_id | Marchand concerné lorsque l’événement est marchand-scoped ; peut être null pour un événement de niveau compte. |
party_id | Tiers associé lorsque le producteur de l’événement dispose de cette identité. Le champ est absent lorsqu’il n’est pas applicable. |
occurred_at | Horodatage ISO 8601 UTC de l’occurrence. |
context | Contexte de corrélation public, notamment la source et, lorsqu’ils existent, les identifiants de requête ou de corrélation. |
payload | Données propres au type d’événement. Ne supposez pas que tous les payloads sont des objets métier complets. |
GET /v1/events retourne la liste des types disponibles. Sans merchant_id, cette liste inclut le catalogue global ; avec un marchand, les événements d’extensions sont limités aux extensions actives et accessibles pour ce marchand. Les contrats de déclenchement de processus sont également exposés via les presets d’événements. Voir Introduction aux événements.
Les cinq signaux d’orchestration process.instance.run_requested, process.instance.retry_requested,process.instance.retry_due, process.instance.timer_due et process.user_action.completedsont observables par webhook mais ne sont pas proposés comme launchers de processus. Cela évite de transformer des signaux internes au lifecycle d’exécution en boucles de déclenchement implicites.
Tiers et contacts
| Type | Déclencheur de processus | Repère métier |
|---|---|---|
party_contact_role.certified | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party_contact_role.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party_contact_role.expired | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party_contact_role.revoked | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party_contact.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party_contact.reactivated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party_contact.suspended | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party_contact.updated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party_group.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party_group.deleted | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party_group.updated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party.assigned_to_group | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party.reactivated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party.removed_from_group | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party.risk_score_updated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party.suspended | Oui | Voir le contrat de l’événement et l’objet métier associé. |
party.updated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
Onboarding et conformité
| Type | Déclencheur de processus | Repère métier |
|---|---|---|
compliance_check.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
compliance_check.error | Oui | Voir le contrat de l’événement et l’objet métier associé. |
compliance_check.expired | Oui | Voir le contrat de l’événement et l’objet métier associé. |
compliance_check.failed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
compliance_check.passed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
compliance_check.review_required | Oui | Voir le contrat de l’événement et l’objet métier associé. |
onboarding_case.approved | Oui | Voir le contrat de l’événement et l’objet métier associé. |
onboarding_case.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
onboarding_case.company.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
onboarding_case.completed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
onboarding_case.individual.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
onboarding_case.rejected | Oui | Voir le contrat de l’événement et l’objet métier associé. |
onboarding_case.review_required | Oui | Voir le contrat de l’événement et l’objet métier associé. |
risk_score.degraded | Oui | Voir le contrat de l’événement et l’objet métier associé. |
risk_score.improved | Oui | Voir le contrat de l’événement et l’objet métier associé. |
Commerce clients
| Type | Déclencheur de processus | Repère métier |
|---|---|---|
checkout_session.abandoned | Oui | Voir le contrat de l’événement et l’objet métier associé. |
checkout_session.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
checkout_session.completed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
checkout_session.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
checkout_session.expired | Oui | Voir le contrat de l’événement et l’objet métier associé. |
order.advance_received | Oui | Voir le contrat de l’événement et l’objet métier associé. |
order.advance_refunded | Oui | Voir le contrat de l’événement et l’objet métier associé. |
order.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
order.completed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
order.confirmed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
order.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
order.fulfilled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
order.updated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
return.authorized | Oui | Voir le contrat de l’événement et l’objet métier associé. |
return.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
return.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
return.inspected | Oui | Voir le contrat de l’événement et l’objet métier associé. |
return.received | Oui | Voir le contrat de l’événement et l’objet métier associé. |
return.resolved | Oui | Voir le contrat de l’événement et l’objet métier associé. |
return.shipped | Oui | Voir le contrat de l’événement et l’objet métier associé. |
Facturation, créances et litiges
| Type | Déclencheur de processus | Repère métier |
|---|---|---|
credit_note.applied | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_note.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_note.issued | Oui | Voir le contrat de l’événement et l’objet métier associé. |
dispute.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
dispute.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
dispute.resolved | Oui | Voir le contrat de l’événement et l’objet métier associé. |
due_date_calendar.suspended | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.dispute_cleared | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.disputed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.due_date_stage_reached | Oui | Une facture atteint une étape configurée de son calendrier d’échéance. |
invoice.issued | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.overdue | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.paid | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.partially_paid | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.received | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.sent | Oui | Voir le contrat de l’événement et l’objet métier associé. |
invoice.terminal_settlement_changed | Oui | Le règlement d’un document déjà terminal change et peut nécessiter une reprise métier. |
receivable.due_date_stage_reached | Oui | Voir le contrat de l’événement et l’objet métier associé. |
receivable.overdue | Oui | Voir le contrat de l’événement et l’objet métier associé. |
receivable.updated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
receivable.zero | Oui | Le solde ouvert du tiers atteint zéro. |
Crédit et exposition
| Type | Déclencheur de processus | Repère métier |
|---|---|---|
credit_exposure.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_exposure.consumed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_exposure.consumption_reversed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_exposure.expired | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_exposure.granted | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_exposure.overconsumed | Oui | La consommation constatée dépasse la capacité disponible ; le fait reste enregistré et observable. |
credit_exposure.released | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_exposure.settled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_limit.approaching | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_limit.exceeded | Oui | Voir le contrat de l’événement et l’objet métier associé. |
credit_limit.updated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
Paiements entrants
| Type | Déclencheur de processus | Repère métier |
|---|---|---|
payment_application.complete | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payment_application.partial | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payment_refund.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payment_refund.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payment_refund.executed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payment_refund.failed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payment_refund.matched | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payment.matched | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payment.partially_matched | Oui | Une partie du mouvement financier est rapprochée et un solde reste à affecter. |
payment.received | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payment.reversed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payment.unmatched | Oui | Voir le contrat de l’événement et l’objet métier associé. |
psp_payment.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
psp_payment.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
psp_payment.disputed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
psp_payment.failed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
psp_payment.partially_funded | Oui | Le PSP payment a reçu une partie, mais pas la totalité, du montant attendu. |
psp_payment.succeeded | Oui | Voir le contrat de l’événement et l’objet métier associé. |
psp_refund.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
psp_refund.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
psp_refund.failed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
psp_refund.succeeded | Oui | Voir le contrat de l’événement et l’objet métier associé. |
Achats et paiements fournisseurs
| Type | Déclencheur de processus | Repère métier |
|---|---|---|
outgoing_payment.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
outgoing_payment.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
outgoing_payment.executed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
outgoing_payment.failed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
outgoing_payment.scheduled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
outgoing_refund.matched | Oui | Voir le contrat de l’événement et l’objet métier associé. |
outgoing_refund.received | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payable.overdue | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payable.updated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
payable.zero | Oui | Voir le contrat de l’événement et l’objet métier associé. |
purchase_order.advance_paid | Oui | Voir le contrat de l’événement et l’objet métier associé. |
purchase_order.advance_refunded | Oui | Voir le contrat de l’événement et l’objet métier associé. |
purchase_order.approved | Oui | Voir le contrat de l’événement et l’objet métier associé. |
purchase_order.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
purchase_order.completed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
purchase_order.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
purchase_order.fulfilled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
purchase_order.sent | Oui | Voir le contrat de l’événement et l’objet métier associé. |
purchase_order.updated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
supplier_credit_note.applied | Oui | Voir le contrat de l’événement et l’objet métier associé. |
supplier_credit_note.received | Oui | Voir le contrat de l’événement et l’objet métier associé. |
supplier_invoice.approved | Oui | Voir le contrat de l’événement et l’objet métier associé. |
supplier_invoice.cancelled | Oui | Voir le contrat de l’événement et l’objet métier associé. |
supplier_invoice.disputed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
supplier_invoice.overdue | Oui | Voir le contrat de l’événement et l’objet métier associé. |
supplier_invoice.paid | Oui | Voir le contrat de l’événement et l’objet métier associé. |
supplier_invoice.partially_paid | Oui | Voir le contrat de l’événement et l’objet métier associé. |
supplier_invoice.received | Oui | Voir le contrat de l’événement et l’objet métier associé. |
supplier_invoice.updated | Oui | Voir le contrat de l’événement et l’objet métier associé. |
Orchestration et approbations
| Type | Déclencheur de processus | Repère métier |
|---|---|---|
approval_request.created | Oui | Voir le contrat de l’événement et l’objet métier associé. |
approval_request.expired | Oui | Voir le contrat de l’événement et l’objet métier associé. |
approval_request.resolved | Oui | Voir le contrat de l’événement et l’objet métier associé. |
process.instance.replayed | Oui | Voir le contrat de l’événement et l’objet métier associé. |
process.instance.retry_due | Non | Voir le contrat de l’événement et l’objet métier associé. |
process.instance.retry_requested | Non | Voir le contrat de l’événement et l’objet métier associé. |
process.instance.run_requested | Non | Voir le contrat de l’événement et l’objet métier associé. |
process.instance.stopped | Oui | Une demande d’arrêt a conduit l’instance à son état terminal stopped. |
process.instance.timer_due | Non | Voir le contrat de l’événement et l’objet métier associé. |
process.user_action.completed | Non | Une action utilisateur en attente a été complétée et peut permettre à l’instance de reprendre. |
Événements d’extension
Les extensions publient leurs propres événements sous l’espace de noms extension.{extension_key}.{event_type}. Leur existence, leurs entrées typées et leur disponibilité proviennent du contrat de chaque extension ; ils ne sont donc pas recopiés dans ce catalogue Core.
Exemples représentatifs : extension.stripe.payment_intent.succeeded ou un événement métier propre à une autre extension installée. Consultez la rubrique Événements de l’extension concernée pour le catalogue exact. La configuration des endpoints entrants est expliquée dans Webhooks entrants des extensions.