Overview

The OneSpan External State Extension allows data to be collected in a SmartIQ form/PDF document and sent to OneSpan for signatures. Once the signature process is complete, OneSpan sends the result to SmartIQ so the workflow can be continued or finalized. The process relies on Cloud to Cloud (C2I) integration between the two platforms.

Configuration

To receive the OneSpan response, SmartIQ exposes a WebHook specifically designed to receive authenticated and validated messages.

Configure Manage Settings

In Manage, go to Settings > OneSpan.
Specify a Callback Key. A relatively long string, similar to a guid.
Save the Settings.

OneSpan Configuration

Go to your OneSpan console and register for event notifications.
Set the callback URL to your produce URL) + /webhooks/OneSpan. For example, <https://companyname.smartcommunications.cloud/produce/webhooks/OneSpan> .
Set the callback key to the same value that was entered in Manage settings.
Select event notifications to send to SmartIQ.

📘
Handled Events
Only the events listed will processed. Others will be logged (if debug mode is on) and ignored.

Event	Display Name	Description
PACKAGE_COMPLETE	Complete	A package has completed the signing process. If there are multiple signers then the "sessionUser": "...", will be the signer ID of the last signer to sign.
PACKAGE_TRASH	Trash	A package was moved to the trash folder in OneSpan Sign's Inbox (status = TRASH).
PACKAGE_DELETE	Delete	A package has been deleted from the OneSpan Sign.com system.
PACKAGE_DECLINE	Decline	A recipient has declined to sign a package, and has specified a reason for doing so, The Originating System can use that reason to determine the next step for the package.
PACKAGE_EXPIRE	Expire	A package has exceeded its expiration date.
PACKAGE_OPT_OUT	Opt_Out	A recipient has opted out of signing a package.
PACKAGE_ARCHIVE	Archive	A callback notification indicates that a package has been archived.

You can now add an External State Event to your workflow project and select the OneSpan state type.