This topic contains 19 replies, has 4 voices, and was last updated by  Duo_Liang 5 days, 14 hours ago.

  • Author
    Posts
  • Participant
    N_Devi_Navya
    Member
    Member since: 02.09.2016
    Number of posts: 27

    Hello Team,

    Can we remove the signature that is captured @Package Level which we use to apply again on the further docs of that package. Instead of creating new package to capture new signature on Signer change.

    Thanks,
    Navya.

    Keymaster
    Duo_Liang
    Guru
    Member since: 14.06.2018
    Number of posts: 290

    Score

    0

    Hi Navya,

    Yes, OneSpan Sign do have the capability to enforce signers to capture their signature every time in a package.

    This is an attribute field in your ceremony settings: "enforceCaptureSignature": false By default, it’s false.

    You can contact support@esignlive.com to set enforce capture on your account.

    Or you can set this attribute in your request payload on a transaction by transaction basis:

    "settings":{
         "ceremony":{
              "enforceCaptureSignature": true
         }
    }

    Hope this reply could help you!


    Duo Liang
    OneSpan Junior Technical Evangelist
    Participant
    N_Devi_Navya
    Member
    Member since: 02.09.2016
    Number of posts: 27

    Score

    0

    Hello Duo Liang,

    Yes this is really helpful. This is not applying the signature captured later to next signing block in the document. But we want the signature to be stored and applied further.

    Thanks,
    Navya.

    Keymaster
    Duo_Liang
    Guru
    Member since: 14.06.2018
    Number of posts: 290

    Score

    0

    Hi Navya,

    For further use, if you are talking about internal signers, OneSpan Sign has the ability to create sender accounts under your main account to store signatures for your internal signers.

    If these are not internal folks, you should follow the below steps:
    1.Retrieve the signer’s handdrawn value(base 64 string). And it could be done in two ways(way one is more straightforward from my opinion):
    (1) retrieve through api which is contained by package information, or to make it more exact, in role block or approval block, so the following two apis both works:

    GET /packages/{packageId}/documents/{documentId}/approvals/{approvalId}
    GET /packages/{packageId}/roles/{roleId}

    (2) download image format of signature(guidance) via api and change it to base 64 string by import tool:

    GET /api/packages/{packageId}/roles/{roleId}/signatureImage

    2.Store this handdrawn as well as signer’s email in your application system.
    3.Next time before sending a package, if you want to upload a captured signature for a signer, add this handdrawn attribute into role block of your request payload like below:

    "roles":[
          {
             "id":"Signer1",
             "type":"SIGNER",
             "signers":[
                {
                   "email":"xxx@mailinator.com",
                   "firstName":"1_firstname",
                   "lastName":"1_lastname",
                   "id":"Signer1",
                   "signature":{
                                 "handdrawn":"signer's handdrawn value"
                   }
                }
             ],
             "name":"Signer1"
          }
       ]

    Hope you find this reply helpful!


    Duo Liang
    OneSpan Junior Technical Evangelist
    • This reply was modified 2 months, 2 weeks ago by  Duo_Liang.
    • This reply was modified 2 months ago by  Duo_Liang.
    Participant
    sushmakanugu
    Regular Member
    Member since: 24.05.2016
    Number of posts: 48

    Score

    0

    Hello Duo Liang,

    Thank you for sharing the api’s. How can we achieve this when sending documents to package at once. Suppose, I have created a package with 5 documents and enforceCaptureSignature is false. Done signing all the documents. Now i will add 3 more documents to the package, so index will be starting from 6. Now on 6th document i want to capture signature(this can be achieved by setting enforceCaptureSignature to true) and apply this newly captured signature on to 7th and 8th document. Is this possible? If yes, how can we achieve this?

    Thanks,
    Sushma

    Keymaster
    Duo_Liang
    Guru
    Member since: 14.06.2018
    Number of posts: 290

    Score

    0

    Hi Sushma,

    I guess the signer(s) in document 6th 7th 8th is in the signers of the first five documents, right? That’s why you wanted to enforce them to capture signature again in 6th doc and apply them on 7th 8th doc.
    I tested the use case for you and my suggestion is:
    1. After finish the first five documents, you would change the status of package to “DRAFT”.
    2. Update signers, remove their “handdrawn” value. That is to say, remove the original captured signature they input. Below is the api to update signer:

    PUT /api/packages/{packageId}/roles/{roldId}

    3. Add three more documents, assigned signatures for signers and send package again.

    In this approach, you don’t need to change the “enforceCaptureSignature” in settings. If the handdrawn attribute is cleared, signers are prompted to capture their signature again, and would definitely applied to 7th 8th document.

    Hope this reply could help you!


    Duo Liang
    OneSpan Junior Technical Evangelist
    • This reply was modified 2 months, 1 week ago by  Duo_Liang.
    • This reply was modified 2 months, 1 week ago by  Duo_Liang.
    Participant
    sushmakanugu
    Regular Member
    Member since: 24.05.2016
    Number of posts: 48

    Score

    0

    Hello Duo Liang,

    I tried to remove the handdrawn value but not successful. Could you help me out with this? Could you remove handdrawn value for role(Buyer) for this package UmW8PRi4pAkQ2nOSusL_Z4N5xSs= in sandbox?

    Thanks,
    Sushma

    • This reply was modified 2 months, 1 week ago by  sushmakanugu.
    Keymaster
    Duo_Liang
    Guru
    Member since: 14.06.2018
    Number of posts: 290

    Score

    0

    Hi Sushma,

    Unfortunately we can’t modify your package for you, but I would definitely explain it more clearly to you.
    To modify a role:
    1. First you would retrieve the json payload by below api call:

    GET /api/packages/{packageId}/roles/{roleId}

    2. Copy all the response payload, just remove the “signature” block, below is an example of what you need to remove:

       "signature": {
                    "handdrawn": "AQAAAGsVwznvKxzHeRQGPs+tZ2WUApQAAwADAJkAAAADAAAAlAKUAEcAAAACXhVAJEAFQB5BA0E4QQdBAEAGUCZQDFEAcVlwTnBNcE9wF1CSQHFAk0DlQNdAqWAZYCdgS2BaYDVQl1BWUOpQtEDQQKFAnEAqQAdARUAUUHFQV1B6UIpQRUCJQIpAZkCEQHJAYEBwUIFQZVA1UFRQc0DgQOVApI5AUUBgQHBQF3ArcLdwwnRyYLBgUKs=",
                    "textual": null
                        },

    3. Use this json as the request payload for the update call:
    PUT /api/packages/{packageId}/roles/{roldId}

    Please make sure the status of package is in “DRAFT”, otherwise you won’t be able to update attributes.

    Hope this could help me and please tell me if there’s any other issues!


    Duo Liang
    OneSpan Junior Technical Evangelist
    • This reply was modified 2 months, 1 week ago by  Duo_Liang.
    Participant
    sushmakanugu
    Regular Member
    Member since: 24.05.2016
    Number of posts: 48

    Score

    0

    Hello Duo Liang,

    I tried the same. Updated the role removing the signature. I moved the package to inbox mode. Now i did get the role info using api, but i still see the handdrawn value. Am I missing something?

    Thanks,
    Sushma

    Keymaster
    Duo_Liang
    Guru
    Member since: 14.06.2018
    Number of posts: 290

    Score

    0

    Hi Sushma,

    Did you mean you updated the role info in “SENT” status(in inbox mode) instead of “DRAFT” status(in drafts mode)?
    If so, you should modify the status of package to “DRAFT”, guidance here. Or click “Edit” in your sandbox UI interface.
    If I misunderstood it, please let me know:)


    Duo Liang
    OneSpan Junior Technical Evangelist
    • This reply was modified 2 months, 1 week ago by  Duo_Liang.
    Participant
    sushmakanugu
    Regular Member
    Member since: 24.05.2016
    Number of posts: 48

    Score

    0

    I have put the package in “DRAFT” mode. Updated the role by removing the signature. Now i have put the package in “SENT” mode. Retrieved the role using api. In the response, i still see the signature handdrawn value.

    Thanks,
    Sushma

    Keymaster
    Duo_Liang
    Guru
    Member since: 14.06.2018
    Number of posts: 290

    Score

    0

    Hi Sushma,

    Sorry we couldn’t get access to your package information, something goes wrong with the backend system. What I can suggest is:
    1. If the signer who you want to remove signature is the sender, you can’t upload role directly by that api call.
    (1)You need to update sender by following api:

      POST /api/account/senders/{senderId}

    with payload:

    {
           "signature": {
               "handdrawn": null,
               "textual": null
            }
        }

    (2)Then you can upload your role by the same approach mentioned above.

    2. Or you can create another package, try again and tell me the package id.


    Duo Liang
    OneSpan Junior Technical Evangelist
    Participant
    sushmakanugu
    Regular Member
    Member since: 24.05.2016
    Number of posts: 48

    Score

    0

    Hello Duo Liang,

    Am trying to remove handdrawn value of a signer only. Here is the package su97uhfMfiOmkrZQJSUQWBLWUNs= and role is Buyer.

    Thanks,
    Sushma

    Keymaster
    Duo_Liang
    Guru
    Member since: 14.06.2018
    Number of posts: 290

    Score

    0

    Hi Sushma,

    We still couldn’t get access to the second package you gave me. Have you figured out what was the problem?

    And before we go any further down this road, can you please provide the actual use case for this and why you would want to enforce capture for 5 documents, then, add more documents and enforce capture on one document, then, not on the final two documents? The original thread topic was just about reusing signature data in subsequent transactions. We’ve deviated quite a bit from that path.

    Depending on the reasoning for this flow, it might just make more sense to do this over two transactions with the first 5 documents having forced capture set to true and the second transaction with the last 3 transactions set to false.

    Please let me know the use case and reason for needing to do it this way.

    Thanks,

    Duo


    Duo Liang
    OneSpan Junior Technical Evangelist
    Participant
    sushmakanugu
    Regular Member
    Member since: 24.05.2016
    Number of posts: 48

    Score

    0

    Hello Duo Liang,

    I didn’t get succeeded on removing the existing signature and capture the signature again on 5th document. The purpose of this is, if we create a package now with 4 documents and signer signed it. And when we add more documents at later point of time to same package, we want the signer to capture again on 5th document and get it applied to next documents. And we don’t want to get the signature captured on each and every document. So, is this possible? When i tried the steps you provided, to update the signature field as null and add documents again, it is not capturing the signature again.

    Thanks,
    Sushma

You must be logged in to reply to this topic.