API REST DocuSign Payments create Tab

Question

J'essaie de créer un exemple d'onglet de formule dans ma création d'enveloppe DocuSign pour demander un paiement (API REST). J'ai créé avec succès les onglets signHere pour plusieurs de nos produits, mais on me demande maintenant de créer un onglet dans lequel le destinataire peut signer en premier, puis effectuer un paiement. Les passerelles de paiement sont configurées (et testées via l'interface graphique du compte DocuSign normal) donc je ne pense pas que le problème soit là.

Je reçois un "Erreur - Veuillez entrer un montant de paiement valide." Une fois que j'essaie de terminer ... mais il n'y a pas d'invite pour un montant de paiement ... ou moyen d'entrer un montant.

Vous cherchez quelque chose qui serait proche de ce format:

"<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>" + 

Toutes les idées?

Answer 1

L'onglet Formule donnera au signataire un message contextuel pour remplir les détails de la carte de crédit/compte, mais rien ne sera affiché sur le document. Ils doivent donc utiliser la combinaison de l'onglet Nombre et de l'onglet Formule pour afficher le montant sur le document et obtenir les détails de la carte/du compte à l'aide de l'onglet Formule.

extrait complet JSON ressemblera ci-dessous:

Numéro onglet affiche l'onglet de paiement sur le document, indiquant montant de 250 dollars puis Formule Tab prendra référence à partir de l'onglet Nombre de calculer la valeur totale pour être montré au client comme Popup pour obtenir les détails de carte de crédit.

Dans l'onglet Formule, "amountReference" et "formula" sont calculés à l'aide de la référence 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 
}] 

isPaymentAmount doit être fausse si vous utilisez notre nouveau PaymentsAPI avec rayure, Braintree et Authorize.Net.

Answer 2

Amit K Bist m'a donné une meilleure direction avec la solution json. Après quelques essais et erreurs, j'ai pu utiliser cette aide et trouver le XML suivant qui semble fonctionner pour nous. La syntaxe de XML doit être parfaite et difficile à obtenir sans exemple. J'espère que cet exemple aide les autres aussi.

 "<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>" +