OneSpan Sign Developer: Downloading Documents and Decline Reasons
In this blog, I will go over what you might have missed in the OneSpan Sign Developer Community during the week of June 11, 2018. Let us get straight to it.
Downloading Default Consent Document
When creating a new sandbox account, a default electronic disclosure and signature consent document is included for every new transaction you create. By making a request to our support team ([email protected]), you can choose to disable this document or have it replaced by your own at the account level. If you choose to keep a default electronic disclosure and signature consent document, then you have the ability to download this document just as any other document in your transaction. Below are sample codes on how to download this particular document:
REST API
GET https://sandbox.esignlive.com/api/packages/{packageId}/documents/default-consent/pdf
Java SDK
byte[] docWithId = eslClient.downloadDocument("{packageId}", "default-consent");
.NET SDK
byte[] docWithId = eslClient.DownloadDocument("{packageId}", "default-consent");
Note that the electronic disclosure and signature consent document will always have “default-consent” as document id.
Retrieve Decline Reasons
Elsewhere, if a recipient declines a transaction, then he or she will have to either choose a predefined decline reason or manually input one. In the eventuality of a declined transaction, you have the ability to retrieve the complete details of this action. For example, you can retrieve the name and the email of the recipient who declined, as well as the timestamp. You can follow this feature guide on how to retrieve decline reasons.
If you have questions regarding this blog or anything else concerning integrating OneSpan Sign into your application, visit the Developer Community Forums: developer.esignlive.com. That's it from me. Thank you for reading! If you found this post helpful, please share it on Facebook, Twitter, or LinkedIn. You can find all of my previous blogs by going to my author page.
Haris Haidary
Technical Consultant