0

使用 REST API,我一直在尝试为嵌入式签名创建收件人,但仍然需要 ID 检查。我似乎无法让它工作。嵌入式签名部分工作正常,但没有提示我进行 ID 检查。

我知道通过嵌入式签名,我的应用程序可以处理用户身份验证职责,但我们的企业仍然希望让签名者使用 ID 检查功能进行身份验证。

那么,是否可以将 ID 检查功能与嵌入式签名一起使用?

4

2 回答 2

1

使用 DocuSign REST API 创建信封时如何指定收件人身份验证方法取决于您是否:

1) 使用 DocuSign 模板创建信封或 2) 通过提供文档作为创建信封 API 调用的一部分来创建信封。

在第一种情况下(使用 DocuSign 模板创建信封),您可以在 Create Envelope API 调用中使用复合模板来指定 ID 检查作为收件人身份验证的形式(即使您的模板没有指定任何形式的收件人身份验证) . 例如,此请求将创建一个信封(使用模板),为嵌入式收件人指定 ID 检查:

发布 https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes

{
"emailSubject": "Please sign",
"emailBlurb": "Please sign...thanks!",
"status": "sent",
"compositeTemplates": [
    {
        "serverTemplates": [
            {
                "sequence": 1,
                "templateId": "YOUR_TEMPLATE_ID"
            }
        ],
        "inlineTemplates": [
            {
                "sequence": 2,
                "recipients": {
                    "signers": [
                        {
                            "email": "test@test.com",
                            "name": "Sally Adamson",
                            "recipientId": "1",
                            "clientUserId": "YOUR_CLIENT_USER_ID_VALUE",
                            "roleName": "Signer 1",
                            "requireIdLookup": "true",
                            "idCheckConfigurationName": "ID Check $"
                        }
                    ]
                }
            }
        ]
    }
]
}

请注意,您必须将requireIdLookup属性设置为true并将idCheckConfigurationName属性设置为收件人的ID Check $,以将 ID Check 指定为收件人身份验证方法。

在后一种情况下(通过提供文档作为创建信封 API 调用的一部分来创建信封),您只需将requireIdLookup属性设置为true并将idCheckConfigurationName属性设置为收件人的ID Check $。例如,此收件人结构(当包含在 Create Envelope API 请求的上下文中时)指定收件人将通过 ID 检查进行身份验证:

"recipients": {
    "signers": [
        {
            "email": "test@test.com",
            "name": "Bob Adamson",
            "recipientId": "1",
            "routingOrder": "1",
            "idCheckConfigurationName": "ID Check $",
            "requireIdLookup": "true",
            "tabs": {
                "signHereTabs": [
                    {
                        "recipientId": "1",
                        "tabLabel": "Customer_Signature",
                        "documentId": "1",
                        "pageNumber": "1",
                        "xPosition": "100",
                        "yPosition": "100"
                    }
                ]
            }
        }
    ]
}
于 2013-09-16T15:32:54.933 回答
0

这里可能有一个错误,但我通过在模板收件人身份验证设置中指定 RDA ID 检查来使其工作,然后当我在嵌入式签名 API 调用中引用该模板时,它在允许访问之前在 ID 检查开始信封。

这样做可以确认您可以将 RSA ID 检查与嵌入式签名相结合,这就是该部分的答案。但是,我必须在控制台中的模板级别设置 RSA 身份验证,并且我的请求中的requireIdLookup属性似乎被忽略了,这让我认为存在错误。

我将跟进 DocuSign 关于该属性对信封没有影响的问题,但是现在您应该能够按照上面的说明让它工作。如果您有时使用该模板并且不希望对收件人进行 RSA ID 检查,那么您可以简单地制作另一个完全相同但添加 ID 签入的模板,并在您的 API 调用中引用该新模板并在以下情况下使用第一个模板你不想要 RSA ID 检查。

于 2013-09-04T23:31:59.110 回答