找不到关于DocuSign高级签名特性的文档

Question

我正在尝试创建一个具有高级签名的收件人。这意味着收件人必须通过短信接收OTP才能签署。它与access身份验证不同，访问身份验证需要进行身份验证才能查看文档。

以下是官方DocuSign对此特性的描述：正式文件

我知道DocuSign有这个功能，它是在我的帐户上激活的，我可以在网络人机界面上使用它。但我找不到怎么用API.我尝试了类签名者的不同字段，但都没有成功。我在网上也找不到文件。

有谁有主意吗？一份文件？还是我需要设置的字段的直接名称？一切都会很棒的！我正在Java中使用REST。

非常感谢,

CodingDawn >感谢您的帮助，但您的答复不符合我的需要。您说的是"DocuSign Express“签名，我说的是"DocuSign EU Advanced”签名。这幅图像来自DocuSign的网络人机界面，用于创建一个信封。你可以清楚地看到，这两个签约是不一样的。例如，"Docusign“签名不需要电话号码。

但是谢谢你给了我更多的线索。

Answer 1

首先，确定签名者将从以下列表中使用的签名提供程序。这份清单被合理地增加了很多次。今后我们将在docs.docusign.com上发布新的和更新的列表。

更新：基于标准的签名API文档现在可用。

当前签名提供程序选项

不使用数字证书的电子签名电子签名。这些是来自DocuSign的默认签名类型

• API signatureProviderName：UniversalSignaturePen_ImageOnly
• 所需选项:无

特快专递签名文档生成通用，“在飞”数字签名，其中包括一个证书。

• API signatureProviderName：UniversalSignaturePen_Default
• 所需选项:无

EU高级签名文档生成，eIDAS AES兼容签名.更多信息。

• API signatureProviderName：UniversalSignaturePen_OpenTrust_Hash_TSP
• 所需选项: SMS或oneTimePassword

Itagile QES签名使用Itagile EU合格证书更多信息

• API signatureProviderName：UniversalSignaturePen_ItAgile_TSP
• 所需选项:无

在信封中包含recipientSignatureProviders 参数: create

该参数接受一个recipientSignatureProvider对象数组。它在定义部分的信封:创建页面中有文档记录。

还至少包括上面列出的选项。

Options

• oneTimePassword描述:收件人在使用欧盟高级签名提供程序时需要输入的访问代码。
• signerRole描述:收件人的角色或能力(例如:经理、批准者等)
• sms描述:接收者应该接收访问代码的电话号码。接收方在使用欧盟高级程序时需要访问代码。请注意，这必须是以+和国家代码开头的字符串，后面跟着没有任何空格或特殊字符的完整移动电话号码。示例：+14155551234，+97235551234，+33505551234

recipientSignatureProviders 示例

具有DS签名提供程序的签字人收件人

{          
    "signers": [{
        "routingOrder": 1,
        "name": "Darryl Sanders",
        "email": "darryl@example.com",
        "deliveryMethod": "email",
        "recipientId": "69693724",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_default"
        }]
    }]
}

一位接受者用eSignature笔，另一位用DS Express

{
    "signers": [{
        "routingOrder": 1,
        "name": "Doris Sunshine",
        "email": "doris@foobar.com",
        "deliveryMethod": "email",
        "recipientId": "68539752",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_imageonly"
        }]
    },
    {
        "routingOrder": 2,
        "name": "Sam Tolliver",
        "email": "sam@me.com",
        "deliveryMethod": "email",
        "recipientId": "39578164",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_default"
        }]
    }]
}

EUAdvanced收信人与短消息接受者和接入代码接受者

{
    "signers": [{
        "routingOrder": 1,
        "name": "Sue Collins",
        "email": "sue@example.com",
        "deliveryMethod": "email",
        "recipientId": "39977897",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_opentrust_hash_tsp",
            "signatureProviderOptions": {
                "oneTimePassword": "12345678"
            }
        }]
    },
    {
        "routingOrder": 2,
        "name": "Yan",
        "email": "jim@me.com",
        "deliveryMethod": "email",
        "recipientId": "89536038",
        "signingGroupId": "",
        "recipientSignatureProviders": [{
            "signatureProviderName": "universalsignaturepen_opentrust_hash_tsp",
            "signatureProviderOptions": {
                "sms": "+1 330-310-3330"
            }
        }]
    }]
}

Answer 2

您必须设置requireSignerCertificate属性

下面是PostEnvelope请求的一个示例

POST /v2/accounts/{accountId}/envelopes

{
  "status": "sent",
  "emailSubject": "Advanced Electronic Signature",
  "emailBlurb": "Advanced Electronic Signature",
  "recipients": {
    "signers": [
      {
        "recipientId": 1,
        "email": "AdvancedElectronicSignature@acme.com",
        "name": "Signer Name",
        "requireSignerCertificate": "docusign_express",
        "requireIdLookup": true,
        "idCheckConfigurationName": "SMS Auth $",
        "smsAuthentication": {
          "senderProvidedNumbers": [
            "555-555-5555"
          ]
        },
        "tabs": {
          "signHereTabs": [
            {
              "documentId": 1,
              "pageNumber": 1,
              "xPosition": 100,
              "yPosition": 100
            }
          ]
        }
      }
    ]
  },
  "documents": [
    {
      "documentId": 1,
      "fileExtension": "pdf",
      "name": "BlankDoc.pdf",
      "documentBase64": : "Specify document bytes here"
    }
  ]
}