PAYMENT_VERIFICATION

Verifies a payment by payment session ID with the Payments service and returns the verification outcome in the trigger metadata.
On success, the action enriches the original payload with fields such as paymentVerified, amount, paymentIdentifier, and paymentProcessor.

When and what fires this action?

If this event is defined on a product, and it has actions that are enabled:

Internally via workflow/actions: Run wherever a payment needs verification after checkout/ authorization.
API: can fire this event externally on demand.

Request payload

POST: https://api.{ENV}.dais.com/ioi/v3/event/fire

curl --location --request POST 'https://api.{ENV}.dais.com/ioi/v3/event/fire' --header 'Authorization: Basic <yourAuthHere>' --header 'Content-Type: application/json' --data-raw '{
  "lineId": "<UUID of the product>",
  "type": "PAYMENT_VERIFICATION",
  "payload": {
    "clientId": "<UUID of the client>",
    "paymentSessionId": "<PAYMENT_SESSION_ID>"
  }
}'

{
  "lineId": "262e67be-c08c-43c0-bb51-06fe4408b4e9",
  "type": "PAYMENT_VERIFICATION",
  "payload": {
    "clientId": "220c4020-7f20-4a16-ba51-d0945804dd83",
    "paymentSessionId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Request fields

Property	Required	Description
`lineId`	`true`	UUID for the product.
`type`	`true`	Must be `PAYMENT_VERIFICATION`.
`payload`	`true`	See below.

Payload fields

Property	Required	Description
`clientId`	`false`	Client identifier, used in activity logging.
`paymentSessionId`	`true`	Session identifier to verify with the Payments service.

Response json

On success, the standard trigger response includes metadata with the verification result:

{
  "triggerRequestId": "<UUID>",
  "executedActionCount": 1,
  "expectedResponseCount": 1,
  "metadata": {
    "PAYMENT_VERIFICATION": {
      "clientId": "220c4020-7f20-4a16-ba51-d0945804dd83",
      "paymentSessionId": "psess_1234567890",
      "paymentVerified": true,
      "amount": 12345,
      "paymentIdentifier": "pi_abc123",
      "paymentProcessor": "STRIPE"
    }
  }
}

Response fields

Property	Required	Description
`triggerRequestId`	`true`	UUID that identifies the execution of the trigger.
`executedActionCount`	`true`	Number of workflow actions executed for this trigger.
`expectedResponseCount`	`true`	Number of responses expected from executed actions.
`metadata`	`true`	Contains dynamically generated data from payment setup actions.