Requirement Created - RalioPay Docs

Event Name: requirement_created

Compliance opened a requirement on one of your orders and is waiting for your response. The message field describes what is needed and expiresAt is the deadline to respond before the requirement expires.

Event Payload

The webhook payload contains the following structure:

{
  "eventId": "550e8400-e29b-41d4-a716-446655440000",
  "eventType": "requirement_created",
  "timestamp": "2026-07-10T09:15:32.481Z",
  "data": {
    "requirementId": "1f2e3d4c-5b6a-4789-8abc-def012345678",
    "orderId": "e5f6a7b8-c9d0-4e1f-2a3b-4c5d6e7f8a9b",
    "merchantId": "7a1f3c5b-2d8e-4f0a-9b6c-1e3d4f5a6b7c",
    "newState": "CREATED",
    "message": "Please provide the invoice or contract supporting this transaction.",
    "expiresAt": "2026-07-17T09:15:32Z"
  }
}

previousState is omitted on this event — the requirement starts its lifecycle here. Respond from the RalioPay Portal before expiresAt; otherwise you will receive requirement_expired.

Overview Requirement In Review

​Event Payload

Event Payload