DocuSign Payments REST API 创建选项卡答案

【问题标题】：DocuSign Payments REST API create TabDocuSign Payments REST API 创建选项卡
【发布时间】：2017-09-11 21:57:10
【问题描述】：

我正在尝试在我的 DocuSign 信封创建中创建一个示例公式选项卡以请求付款（REST API）。我已经成功地为我们的许多产品创建了 signHere 选项卡，但现在我被要求创建一个选项卡，收件人可以先在其中签名然后付款。支付网关已设置（并通过正常的 DocuSign 帐户 GUI 进行测试），所以我认为问题不存在。

我收到“错误 - 请输入有效的付款金额”。一旦我尝试完成......但没有提示支付金额......或输入任何金额的方式。

寻找接近这种格式的东西：

    "<formulaTabs>" +
      "<formulaTab>" +
       "<isPaymentAmount>true</isPaymentAmount><value>125.00</value>" +
       "<tabLabel>CDSetupFee</tabLabel><documentId>1</documentId> 
        <pageNumber>4</pageNumber>" +
       "<xPosition>200</xPosition><yPosition>630</yPosition>" +
      "</formulaTab>" +
    "</formulaTabs>" +

有什么想法吗？

【问题讨论】：

标签： rest tabs formula payment docusignapi

【解决方案1】：

公式选项卡将弹出给签名者以填写信用卡/帐户详细信息，但在文档上，不会显示任何内容。因此，他们应该使用数字标签和公式标签的组合来显示文档上的金额，并使用公式标签获取卡/帐户详细信息。

完整的 JSON sn-p 如下所示：

数字选项卡将在文档上显示付款选项卡，显示金额为 250 美元，然后公式选项卡将参考数字选项卡来计算总价值，以弹出窗口的形式显示给客户以获取信用卡详细信息。

在“公式”选项卡中，“amountReference”和“公式”使用 NumberTab 参考计算。

"numberTabs": [{
    "xPosition": 268,
    "yPosition": 142,
    "documentId": "12345",
    "recipientId": "1",
    "pageNumber": 1,
    "value": 250,
    "maxLength": 4000,
    "width": 80,
    "height": 16,
    "tabLabel": "PaymentFixed 646b5192-a101-4cdc-a7e5-5e9bd1b80612",
    "paymentItemName": "Test Item Name",
    "paymentItemCode": "54321",
    "paymentItemDescription": "Test Item Details"
}],
"formulaTabs": [{
    "paymentDetails": {
        "currencyCode": "USD",
        "gatewayAccountId": "8cfb9a83-1f4c-40b1-b7a9-dd382ee0ca7d",
        "lineItems": [{
            "amountReference": "PaymentFixed 646b5192-a101-4cdc-a7e5-5e9bd1b80612",
            "name": "Test Item Name",
            "description": "Test Item Details",
            "itemCode": "54321"
        }]
    },
    "formula": "([PaymentFixed 646b5192-a101-4cdc-a7e5-5e9bd1b80612]) * 100",
    "recipientId": "1",
    "documentId": "12345",
    "tabLabel": "PaymentReceipt e47eed9a-85ca-4094-8d0f-50e51d5d1ee0",
    "xPosition": 0,
    "yPosition": 0,
    "pageNumber": 1,
    "required": true,
    "locked": true,
    "hidden": true
}]

如果您将我们的新 PaymentsAPI 与 Stripe、Braintree 和 Authorize.Net 一起使用，则 isPaymentAmount 必须为 false。

【讨论】：

【解决方案2】：

Amit K Bist 用 json 解决方案给了我更好的方向。经过一些试验和错误后，我能够使用此帮助并提出以下看起来适合我们的 XML。 XML 的语法需要完美，如果没有示例就很难做到正确。希望这个例子对其他人也有帮助。

       "<numberTabs>" +
            "<number>" +
            //"<isPaymentAmount>true</isPaymentAmount>" +
            "<xPosition>200</xPosition><yPosition>630</yPosition>" +
            "<documentId>1</documentId>" +
            "<recipientId>1</recipientId>" +
            "<pageNumber>4</pageNumber>" +
            "<value>" + AdditionalDeposit + "</value>" +
            "<maxLength>4000</maxLength>" +
            "<width>80</width>" +
            "<height>16</height>" +
            "<tabLabel>PaymentLabel</tabLabel>" +
            "</number>" +
        "</numberTabs>" +

         "<formulaTabs>" +
            "<formulaTab>" +
            "<paymentDetails>" +
            "<allowedPaymentMethods><string>CreditCard,BankAccount</string>
             </allowedPaymentMethods>" +
            "<total><amountInBaseUnit>" + AdditionalDeposit + "
             </amountInBaseUnit><displayAmount>" + AdditionalDeposit + "
             </displayAmount></total>" +
            "<currencyCode>USD</currencyCode><gatewayAccountId>xxxx-xxxx-xxxx-xxxx-xxxx</gatewayAccountId><gatewayName>Stripe_8530</gatewayName>" +
            "<lineItems>" +
            "<paymentLineItem>" +
                 "<amountReference>PaymentLabel</amountReference>" +
                 "<description>CD Additional Deposit</description>" +
                 "<itemCode>PF54321</itemCode>" +
                 "<name>CD Additional Deposit</name>" +
            "</paymentLineItem>" +
            "</lineItems>" +
            "</paymentDetails>" +
            "<formula>([PaymentLabel]) * 100</formula>" +
            "<recipientId>1</recipientId>" +
            "<documentId>1</documentId>" +
            "<tabLabel>CDSetupFee</tabLabel>" +
            "<pageNumber>4</pageNumber><xPosition>0</xPosition>
             <yPosition>0</yPosition>" +
            "<required>true</required>" +
            "<locked>true</locked>" +
            "<hidden>true</hidden>" +
        "</formulaTab>" +
    "</formulaTabs>" +

【讨论】：