AlfonsoEscobar | Posts: 2

Signer/Role Signing status

0 votes

Hello everyone, 

Currently I have a requirement to have multiple signers following a signing order for each transaction. To do this I am creating the transactions with two Roles (I specify the signing order per role) and a signer each. Everything is working fine but a new requirement emerged, we need to know if signer 1 has completed the signing process. As of now we have identify a way to get the transaction's signing status but is it possible to get the signer's signing status? We tried using the signingStatus API but it seems to retrieve the transaction's signing status even if you pass the signer id or the document id.

signingStatus API

 


Duo_Liang | Posts: 3776

Reply to: Signer/Role Signing status

0 votes

Hi AlfonsoEscobar,

 

Thanks for your post!

It's a known documentation mistake that the two parameters should be "signer" and "document" without "id", see below examples:

GET /api/packages/{packageId}/signingStatus?signer={signerId}

GET /api/packages/{packageId}/signingStatus?document={documentId}

GET /api/packages/{packageId}/signingStatus?signer={signerId}&document={documentId}

Both parameters are optional.

On top of that, it's worth mentioning that it is strongly recommended that you use a Callback Listener instead of polling for transaction statuses. The use of polling may consume unnecessary resources on both your end, and on the OneSpan Sign service.

 

Duo

 


JPsOneSpan | Posts: 15

Reply to: Signer/Role Signing status

0 votes

Hi Duo,

Could you show some Java code for getting the "currently signed" signer when A) there are multiple signers and B) the document has not been  completely signed and C) the package is still "In Progress"?

Thanks!

JP


Duo_Liang | Posts: 3776

Reply to: Signer/Role Signing status

1 votes

Hi JP,

 

Attached is a sample code I created, where #1 it's written with OSS Java SDK #2 only pulls package JSON once and all the calculations are done in local #2 depending on how your work flow treats optional signature, your logic could be slightly vary from mine. (In my case, if a signer has left any optional signature, the signing status would still be in progress)

 

Duo


JPsOneSpan | Posts: 15

Reply to: Signer/Role Signing status

0 votes

Thank you Duo!

This is very helpful.

JP


Hello! Looks like you're enjoying the discussion, but haven't signed up for an account.

When you create an account, we remember exactly what you've read, so you always come right back where you left off