---
title: "OneSpan Identity Verification Notification"
slug: "onespan-identity-verification-notification"
updated: 2025-06-27T20:07:11Z
published: 2025-06-27T20:07:11Z
canonical: "docs.onespan.com/onespan-identity-verification-notification"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onespan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OneSpan Identity Verification Notification

OneSpan Identity Verification provides a call-back mechanism for partner applications to receive notifications whenever an e-agreement workflow reaches a certain pre-configured state. This feature enables partner systems to capture the status of a transaction.

Notifications can be configured inside the workflow, which is set up by OneSpan Professional Services based on your requirements. [OneSpan Identity Verification scenarios with notifications](/docs/onespan-identity-verification-notification#Tab_Types_of_notifications) lists the OneSpan Identity Verification scenarios which can be configured inside the workflow to send notifications.

> OneSpan Identity Verification only supports string messages. You need to decide which type of notification to integrate, based on the response messages.

> For security reasons, OneSpan Identity Verification only supports notification endpoints that have a static IP address. Notification endpoints with a dynamic IP address are not supported.

<editor360-custom-block data-preprocessing="true" data-sanitizationtags="a"><div data-type="table-content"> <table width="100%" class=" fr-alternate-rows editor360-table" borderstyle="Solid"> <colgroup style="display:none;"> <col style="width:250px;"> <col style="width:250px;"> </colgroup> <tbody> <tr> <td colspan="2" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="f6fdfadf-6ffb-4add-a2bb-6e65eba8618a"><a name="Tab_Types_of_notifications" display="false"></a><strong>OneSpan Identity Verification scenarios with notifications</strong></p> </td> </tr> <tr> <th colspan="1" rowspan="1" class="TableStyle-Global-HeadE-Column-MainHeader" style="vertical-align:middle;text-align:left;"> <p data-block-id="9971668a-45a7-4eb7-9952-7c06b95bf739">Scenario</p> </th> <th colspan="1" rowspan="1" class="TableStyle-Global-HeadD-Column-MainHeader" style="vertical-align:middle;text-align:left;"> <p data-block-id="57505aec-7434-4827-b6ce-ee7247344744">Options</p> </th> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="a2198501-f123-437f-a5fc-8e7778f0ab89">Transaction</p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <ul data-block-id="afd5c33f-ac2a-438d-b47b-8768db036aaa"> <li data-block-id="4bf1e469-b956-4326-b470-a65579aaf2a0"> <p data-block-id="c678c676-a44c-42f9-b20a-22ec31bd6a62">Created</p> </li> <li data-block-id="8c51b637-5337-440f-95a8-b747a08db0db"> <p data-block-id="b50312d0-f444-4264-9253-279c25dba09f">Completed</p> </li> <li data-block-id="17ef4fcb-57d5-4287-80d6-6432d49e1a3a"> <p data-block-id="b379b9c9-4d3a-4424-8624-38b698d0b665">Expired</p> </li> <li data-block-id="3a0c0328-f875-4dd1-972d-751ff4f58b29"> <p data-block-id="e6bda88a-61e7-47c5-8225-fc7c59ded24f">Cancelled</p> </li> <li data-block-id="9538d341-b32b-4eed-9c54-8e86a74c25d0"> <p data-block-id="ab7b4ba2-038f-4098-af58-2fe817fffc8d">Error</p> </li> <li data-block-id="4a86e51e-cd7a-4176-a734-4874bfa9df7c"> <p data-block-id="d4f9f717-9e4f-4107-bf65-98d075ba238f">Ready for lender</p> </li> </ul> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="a6c09deb-b891-4325-a929-5398c77e135d">Session</p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <ul data-block-id="3d5c6385-f284-4c23-ad43-9ad8dee41b40"> <li data-block-id="b175b74b-4e91-4ad4-aa5a-4c087f951582"> <p data-block-id="9ce676b7-4f8d-4fd5-b6c8-1a72a40805bb">Started</p> </li> <li data-block-id="6242fd5f-385b-47ad-953f-ad6ed45a0502"> <p data-block-id="7af81aa2-efa9-4cc1-8d4c-d8aee80376a4">Ended</p> </li> <li data-block-id="334ebf0e-6801-4ba8-ad63-3812850c1c81"> <p data-block-id="3f7651e8-ee81-4959-8a5c-ed02dee0960b">Error</p> </li> </ul> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="71310f20-741c-4bbd-b1ff-63ca76d0ad32">Document</p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <ul data-block-id="c72fcb96-680e-433b-99d9-80b1ff9ff3aa"> <li data-block-id="f150746f-ea5a-4252-9ddf-91f8a60a474e"> <p data-block-id="34538f00-fcd1-4a83-8559-8b14fa57bbef">Selected</p> </li> <li data-block-id="05a6b3b8-0f2e-4fc1-bdef-3af4d2725532"> <p data-block-id="a3309d75-8c82-4a28-aada-a8ff0047c2a9">Presented</p> </li> <li data-block-id="d76d1ef7-d458-447c-891d-d693e99707ad"> <p data-block-id="043a3fe9-bb16-472c-b4c9-577bd4324f31">Downloaded</p> </li> <li data-block-id="e16bb21d-4a10-4a8f-a7aa-490fbb7f5a84"> <p data-block-id="6c89da28-4ea6-42ed-8cf3-c603722896ca">Downloaded for Printing</p> </li> <li data-block-id="344f7dc8-55ce-4475-9556-4ef588b52ed0"> <p data-block-id="5a7ca57d-5d4e-4a99-81be-05b90a161f65">Printed</p> </li> <li data-block-id="fc95ea47-b112-4c65-8965-2cc6177619cd"> <p data-block-id="07b10403-c396-4941-a18a-c770124b5c96">Accepted</p> </li> <li data-block-id="b09a53f1-b195-4903-be9e-eeb46a9045bf"> <p data-block-id="e68c6efe-61db-480a-99a1-af75e795ee19">Signed</p> </li> <li data-block-id="f252f5e8-f811-414f-aea1-cfdeb799c88d"> <p data-block-id="b150df6e-cd00-4c7e-8e69-b7879a594685">Added</p> </li> </ul> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="71be5c72-c061-45d3-811f-cd853bd2116a">Page view</p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <ul data-block-id="ba0f3665-b3a4-4fbc-b36b-82653e3d7617"> <li data-block-id="545f7ca1-ec11-426b-b999-d5bf22d78e6e"> <p data-block-id="e22e625f-486a-42ea-831f-6bdb249b26c4">Created</p> </li> </ul> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="7de147f2-6861-479e-b7df-5ee01070ab1c">Signature</p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <ul data-block-id="d84ead24-9a92-4ab3-a4fe-b305af4cc5c6"> <li data-block-id="0c5158fd-b2c1-49f6-b21f-0bb5dc8d3367"> <p data-block-id="55a6293e-7571-4f59-898d-56aa47761582">Accepted</p> </li> <li data-block-id="43465549-7c4b-41c6-b23f-de47a16b7c28"> <p data-block-id="e6e35406-538a-4049-9154-d1a95cb92945">Signed</p> </li> </ul> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="299156e2-c2e0-494a-a3df-355e63cc7acc">Verifications</p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <ul data-block-id="bd26ffe8-83c2-4357-ad71-74a58d76157b"> <li data-block-id="b9048290-84a0-4e8a-a7bb-29593f40cea9"> <p data-block-id="5f19866e-8361-4cae-89b6-e9b5214c591a">Doc ID</p> </li> <li data-block-id="59c25f6b-d060-416a-8a70-70a65397b38b"> <p data-block-id="06923926-5046-434f-ad94-40e21d61303c">OTP</p> </li> <li data-block-id="4d432d64-5ce7-4852-b952-b21ff8e41e83"> <p data-block-id="9066b3e9-e19a-4836-aaed-8b047974a669">Document verification with face</p> </li> </ul> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="783a99a2-c3fb-4101-a2b7-30f1b5e2bc7d">Audit trail</p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <ul data-block-id="8776ae62-7bd3-42bd-8797-f714078ab3d4"> <li data-block-id="81c64233-3dd7-4b6e-822e-1f53fbc6179a"> <p data-block-id="7671f1d3-7d54-48b2-9ad6-c21a1d14cb3b">Generated</p> </li> <li data-block-id="53e395c9-d556-414c-8dff-aeaafe328eb4"> <p data-block-id="2547ad64-05b8-495c-bfc2-b28d8b0a8b96">Error</p> </li> </ul> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="7b96659d-0fd9-4a87-9d04-f733753b0373">Consent</p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <ul data-block-id="f10a7876-ae7c-4044-8939-8dff81355c1d"> <li data-block-id="d5e8641e-6692-4606-9839-3ac0336a76b3"> <p data-block-id="e09e6a6e-4168-4a18-9fcb-3e3f176f6085">Accepted</p> </li> </ul> </td> </tr> </tbody> </table></div></editor360-custom-block>

## Example notification: transaction created

1. {
2. @timestamp": "2020-01-17 00:08:31.118 +0000",
3. "type":"notification",
4. "transaction_id":"a17800d8-0208-4052-b2c6-752f07c04dfa",
5. "session_id":"e639bf75-9c16-46f9-b71e-d13e9a8ac8d6",
6. "trigger":"transaction_created",
7. "skip_common_ux_components":true,
8. "skip_view_state":false,
9. "role":"Borrower",
10. "message":"Esignprocessisstarted.",
11. "fields":[],
12. "version":
13. }

## Example notification: consent accepted

In this example, consent information is specified in type and message, and in the fields array.

1. {
2. "timestamp": "2022-07-22T20:32:10.336Z",
3. "type": "consent_accepted",
4. "transaction_id": "16b48158-1de3-4455-b059-65d0205a358b",
5. "session_id": "020b50ee-a730-4906-96a5-ab1f2af6da6f",
6. "id": "33cb6c3c-236f-45af-a48c-85e1870eb32d",
7. "trigger": "page_next",
8. "skip_common_ux_components": true,
9. "skip_view_state": false,
10. "role": "oss",
11. "document_references": [],
12. "message": "Consent is accepted",
13. "client_device": {
14. "ip_address": "192.0.2.15",
15. "name": "Other",
16. "os_version": "Linux",
17. "browser_version": "Chrome 100.0.4896",
18. "browser_width": 1848,
19. "page_height": 948
20. },
21. "fields": [
22. {
23. "name": "explicit-consent",
24. "value": "false"
25. },
26. {
27. "name": "consent-text",
28. "value": "By clicking NEXT you consent to the processing of your personal data for the purpose of verifying your identity."
29. },
30. {
31. "name": "accepted",
32. "value": "true"
33. }
34. ],
35. "version": 0
36. },
