Skip to main content

Callback events

The Truvity EUDIW Connector delivers a Presented Credentials Event to your callback endpoint at the end of each presentation flow. The status field indicates the outcome.

Event statuses

StatusDescription
FULFILLEDVerification succeeded and credentials are available in the event payload
REJECTEDThe wallet declined the presentation request
EXPIREDThe session expired before the wallet responded
PROCESSING_ERRORInternal processing failure (decryption, state validation)
VERIFICATION_FAILEDCredential verification failed (invalid signatures, revoked credentials, DCQL mismatch)

Payload fields by status

The event payload contains different fields depending on the status value.

FieldFULFILLEDREJECTEDEXPIREDPROCESSING_ERRORVERIFICATION_FAILED
stateAlwaysAlwaysAlwaysAlwaysAlways
credentialsPresentAbsentAbsentAbsentAbsent
credentialsRawPresentAbsentAbsentAbsentAbsent
errorDetailsAbsentPresentAbsentPresentPresent
responseCodeSame-device onlyAbsentAbsentAbsentAbsent

errorDetails field

The errorDetails field provides context for non-success statuses.

StatuserrorDetails contents
REJECTEDThe wallet's OAuth 2.0 error code and optional description (for example, access_denied or access_denied: User canceled)
PROCESSING_ERRORA human-readable description of the internal error (for example, decryption errors or state validation failures)
VERIFICATION_FAILEDCredential verification failure details (for example, invalid signatures, revoked credentials, or DCQL mismatches)

responseCode field

For same-device flows, the event includes a responseCode field. The wallet redirects the user's browser back to your app with this code as a query parameter, allowing you to correlate the browser redirect with the callback event.

Further reading