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.
To receive the OneSpan response, SmartIQ exposes a WebHook specifically designed to receive authenticated and validated messages.
- In Manage, go to Settings > OneSpan.
- Specify a Callback Key. A relatively long string, similar to a guid.
- Save the Settings.
- Go to your OneSpan console and register for event notifications.
- Set the callback URL to your produce URL) + /webhooks/OneSpan. For example,
- Set the callback key to the same value that was entered in Manage settings.
- Select event notifications to send to SmartIQ.
Only the events listed will processed. Others will be logged (if debug mode is on) and ignored.
|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.
Updated 8 months ago