Signing through certificate
Friday, May 12, 2023 at 03:04pmHello I am using document extraction approach using REST API and able to create the Transaction successfully. The problem I am having is that when I click to sign, it opens image capture screen like in the attached screenshot. I want to set from property in rest api so that when user click on the sign button, it prompt user to select the digital certificate to sign in transaction. Can you help with REST API?
{
"roles": [
{
"id": "Signer1",
"type": "SIGNER",
"signers": [
{
"email": "[email protected]",
"firstName": "Bill",
"lastName": "Saven"
}
],
"name": "Signer1"
}
],
"documents": [
{
"name": "testDocumentExtraction",
"extract": true
}
],
"name": "Test Document Extraction",
"type": "PACKAGE",
"autoComplete": true,
"status": "SENT"
}
Reply to: Signing through certificate
Friday, May 12, 2023 at 03:56pmHi tirfan,
The OneSpan Personal Certificate Client (PCC) enables users to sign with a digital certificate that resides on a Smart Card or hardware token.
In order to leverage the feature, you'd first contact the support team and turn on the feature in your account.
Once you have the feature enabled, first of all, PCC only supports click-to-sign signatures, thus you'd change your PDF form property to
[Signer1.Fullname1] (instead of [Signer1.Capture1])
In your API flow:
(1)you need to leave the transaction status in DRAFT first:
POST /api/packages
{
"roles": [
{
"id": "Signer1",
"type": "SIGNER",
"signers": [
{
"email": "[email protected]",
"firstName": "Bill",
"lastName": "Saven"
}
],
"name": "Signer1"
}
],
"documents": [
{
"name": "testDocumentExtraction",
"extract": true
}
],
"name": "Test Document Extraction",
"type": "PACKAGE",
"autoComplete": true,
"status": "DRAFT"
}
(2)Invoke an additional API to specify PCC authentication:
POST /api/packages/{packageId}/roles/Signer1/verification
{"typeId":"personalCertificateSigning"}
(3)Send the transaction
PUT /api/packages/{packageId}
{"status":"SENT"}
Duo
Duo Liang OneSpan Evangelism and Partner Integrations Developer