eSignature API > Tutorial: Hello World > eSignAnyWhere API with Postman Sample

eSignAnyWhere with Postman

This tutorial shows how to use Postman with REST/JSON and the eSignAnyWhere API. Here you find our tutorial for SOAP and SoapUI.

Please also see the developer mode for this tutorial here: Visit the developer mode.

Download files for tutorial (JSON for Tutorial, JSON for variables, PDF): Tutorial_Files

Collection

In this tutorial you will do the first API Call as well as sending envelopes, upload documents and download signed papers. Let us start with creating a Collection so that we can save all request there. Therefore, you must go to the register “new” and select Collection. Then Figure 1 should appear where we define a name for our Collection.

Postman Collection
Figure 1: Create a Collection

Create a request

After creating a new Collection, we will save our first request into it. Therefore, you select again the register “new” and pick request. Afterwards the Figure 2 should appear where you choose a name for the request and make sure to save it in the Collection we just created.

Figure 2: Save a Request

First API Call (get the version)

Let us start now with the first API call. As the name of our request tells we will first make an easy call to examine the current version.

You can see all requests here:

https://demo.xyzmo.com/Api/swagger/ui/index

Therefore, you must select the request type to a “Get” request and you must fill in the URL.  For a detailed overview see the next Figure.

Figure 3: First API Call

As you may see from the Figure 3 you just have to fill in the URL, select the correct type (in this case it is a “Get” type) and then you just have to click the send button and you will get such a result as shown in the Figure 3.

If an error appears, make sure you have chosen the correct request type and the right URL.

Version Request JSON

not required

Version Response JSON

{
    "Success": true,
    "Version": "3.4.110.12913"
}

Authorization

The next request will show you an authorization. This is an important part of the requests for sure but not only because of security but also because we will need the authorization for all other requests.

Let us create another request to make our second API Call to try the authorization. The only extension to the previous call is to define the headers. If you click on “Headers” you will see three columns. The first and second one, so the keys and the values are necessary for the authorization.

One key is “userLoginName” and the second one is “organizationKey”. The value for the login name is your email-address and the value for organization key is your organization key.

Figure 4: Authorization

Authorization Request JSON

not required

Authorization Response JSON

Should response 200 OK

Upload a file

Before we can send an envelope, we must make sure that we have already uploaded a file. Therefore, the next request will be about uploading a file.

Figure 5: Upload file

As you can see in Figure 5 you must also edit the body. So, the header will be the same as we have already seen in the authorization. In the body you must select that you will upload a file and you must choose a file which you wanted to be uploaded. (In this case “Tutorial.pdf”)

Attention! It is necessary to change from “none” to “form-data”.

Afterwards you should get a file ID. It is necessary that we do not forget this ID because we will need it for the envelope sending request.

 

Upload Request JSON

not required

Upload Response JSON

{
    "SspFileId": "2f3a35c6-017b-459e-aafd-15c3d78b82e0"
}

Sending an envelope

The sending request is a bit more complicated than the previous once. First, copy the sending description (Example value) from this link:

https://demo.xyzmo.com/Api/swagger/ui/index#/Envelope/Envelope_Send

and paste it in the body of the sending request. Then change from “none” to “raw” and change the File ID to the one you get from the upload file request.

The next Figure should give you an overview of all changes you have to do to get a positive result. (in this case the result is the envelope ID)

Figure 6: Sending an envelope

{
“SspFileIds”: [
“78ddf47a-2ccb-4a92-a36b-702673f9448f”
],
“SendEnvelopeDescription”: {
“Name”: “example”,
“EmailSubject”: “Please sign the enclosed envelope”,
“EmailBody”: “Dear #RecipientFirstName# #RecipientLastName#\n#PersonalMessage#\nPlease sign the envelope #EnvelopeName#\n\nEnvelope will expire at #ExpirationDate#”,
“DisplayedEmailSender”: “”,
“EnableReminders”: true,
“FirstReminderDayAmount”: 5,
“RecurrentReminderDayAmount”: 3,
“BeforeExpirationDayAmount”: 3,
“DaysUntilExpire”: 28,
“CallbackUrl”: “”,
“StatusUpdateCallbackUrl”: “”,
“Steps”: [
{
“OrderIndex”: 1,
“Recipients”: [
{
“Email”: “EMAILADDRESS”,
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“LanguageCode”: “de”,
“EmailBodyExtra”: “”,
“DisableEmail”: false,
“AddAndroidAppLink”: false,
“AddIosAppLink”: false,
“AddWindowsAppLink”: false,
“AllowDelegation”: true,
“SkipExternalDataValidation”: false,
“AuthenticationMethods”: []
}
],
“EmailBodyExtra”: “”,
“RecipientType”: “Signer”,
“WorkstepConfiguration”: {
“WorkstepLabel”: “Download”,
“SmallTextZoomFactorPercent”: 100,
“FinishAction”: {
“ServerActions”: [],
“ClientActions”: []
},
“ReceiverInformation”: {
“UserInformation”: {
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“EMail”: “EMAILADDRESS”
}
},
“SenderInformation”: {
“UserInformation”: {
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“EMail”: “EMAILADDRESS”
}
},
“TransactionCodeConfigurations”: [
{
“Id”: “smsAuthTransactionCodeId”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Value”: “Please authenticate yourself for the access to the envelope with the transactionId {tId}. Your code is: {Token}”
},
{
“Language”: “bg”,
“Value”: “Моля, удостоверете се за достъп до плика с Id {tId} на трансакцията. Вашият код е: {Token}”
},
{
“Language”: “de”,
“Value”: “Bitte authentifizieren Sie sich für den Zugriff auf die Dokumentenmappe der Transaktion {tId}. Ihre TAN lautet: {Token}”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε ταυτοποιηθείτε για την πρόσβαση στον φάκελο με τον αναγνωριστικό κωδικό συναλλαγής {tId}. Ο κωδικός σας είναι: {Token}”
},
{
“Language”: “en”,
“Value”: “Please authenticate yourself for the access to the envelope with the transactionId {tId}. Your code is: {Token}”
},
{
“Language”: “es”,
“Value”: “Autentíquese para acceder al sobre con el ID de transacción {tId}. Su código es: {Token}”
},
{
“Language”: “fr”,
“Value”: “Veuillez vous authentifier afin d’accéder à l’enveloppe avec l’identifiant de transaction {tId}. Votre code est : {Token}”
},
{
“Language”: “it”,
“Value”: “Con riferimento alla transazione {tId}, per autenticarsi si prega di inserire il seguente CODICE {Token}”
},
{
“Language”: “nl”,
“Value”: “U dient zich te authenticeren voor toegang tot enveloppe met transactie-ID {tId}. Uw code is: {Token}”
},
{
“Language”: “pl”,
“Value”: “Dokonaj uwierzytelnienia, aby uzyskać dostęp do koperty z identyfikatorem IDTransakcji {tId}. Twój kod to: {Token}”
},
{
“Language”: “pt-br”,
“Value”: “Por favor autentique-se para acessar ao envelope com o ID: {tId}. Seu código é: {Token}”
},
{
“Language”: “pt-pt”,
“Value”: “Autentique-se para aceder ao envelope com a ID de transação {tId}. O seu código é: {Token}”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa va autentificati pentru accesul la documentul cu numarul de tranzactie {tId}. Codul este: {Token}. ”
},
{
“Language”: “zh-cn”,
“Value”: “请使用事务标识号{tId}验证自己的身分以便访问此信封。您的密码是:{Token}”
}
]
},
{
“Id”: “disposableCertificateEnrolAndSignSmsText”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Value”: “Please confirm the issuance of your disposable certificate and signature, referenced by transactionId {tId}, with the OTP: ”
},
{
“Language”: “bg”,
“Value”: “Моля, потвърдете издаването на Вашия сертификат за еднократна употреба, отнасящ се до Id {tId} на трансакцията, подпишете с OTP: ”
},
{
“Language”: “de”,
“Value”: “Bitte bestätigen Sie die Ausstellung des Einwegzertifikats und die Signatur für Transaktion {tId} mit dem Einmalpasswort: ”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε επιβεβαιώστε την έκδοση του πιστοποιητικού και υπογραφής μίας χρήσης, με αναφορά το Id συναλλαγής {tId}, με το OTP: ”
},
{
“Language”: “en”,
“Value”: “Please confirm the issuance of your disposable certificate and signature, referenced by transactionId {tId}, with the OTP: ”
},
{
“Language”: “es”,
“Value”: “Confirme la emisión de su firma y certificado desechable, a los que se hace referencia por el ID de transacción {tId}, con el OTP: ”
},
{
“Language”: “fr”,
“Value”: “Veuillez confirmer la délivrance de votre signature et certificat référencé par l’identifiant {tId} avec le mot de passe à usage unique : ”
},
{
“Language”: “it”,
“Value”: “Conferma l’emissione del tuo certificato disposable, con riferimento alla transazione {tId}, e della firma con l´OTP ”
},
{
“Language”: “nl”,
“Value”: “Bevestig de afgifte van uw eenmalig certificaat en handtekening, met transactie-ID {tId} en het eenmalig wachtwoord: ”
},
{
“Language”: “pl”,
“Value”: “Potwierdź wydanie jednorazowego certyfikatu i podpisu w związku z transakcją o numerze {tId}, korzystając z OTP: ”
},
{
“Language”: “pt-br”,
“Value”: “Por favor, confirme a emissão do seu certificado e assinatura descartáveis, referenciados por {tId}, com o OTP: ”
},
{
“Language”: “pt-pt”,
“Value”: “Confirme a emissão do seu certificado disponível e a assinatura, referenciado pela ID de transação {tId}, com o OTP: ”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa confirmati emiterea certificatului de unica folosinta si a semnaturii, referitor la numarul de tranzactie {tId}, cu OTP-ul: ”
},
{
“Language”: “zh-cn”,
“Value”: “请确认签发单次性证书和签名,请引用事务标识号{tId},与OTP:”
}
]
},
{
“Id”: “remoteCertificateSignSmsText”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Value”: “Please sign the document, referenced by transactionId {tId}, using the OTP: ”
},
{
“Language”: “bg”,
“Value”: “Моля, подпишете документа, отнасящ се до Id {tId} на трансакцията, като използвате OTP: ”
},
{
“Language”: “de”,
“Value”: “Bitte signieren Sie das Dokument, referenziert durch die Transaktions {tId}, mit dem Einmalpasswort: ”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε υπογράψτε το έγγραφο με αναφορά τον αναγνωριστικό κωδικό συναλλαγής {tId}, χρησιμοποιώντας το OTP: ”
},
{
“Language”: “en”,
“Value”: “Please sign the document, referenced by transactionId {tId}, using the OTP: ”
},
{
“Language”: “es”,
“Value”: “Firme el documento, al que se hace referencia por el ID de transacción {tId}, usando el OTP: ”
},
{
“Language”: “fr”,
“Value”: “Veuillez signer le document, référencé par l’identifiant de transaction {tId}, en utilisant le mot de passe à usage unique : ”
},
{
“Language”: “it”,
“Value”: “Firma il documento, con riferimento alla transazione {tId}, usando l´OTP ”
},
{
“Language”: “nl”,
“Value”: “Onderteken het document met transactie-ID {tId}, met behulp van het eenmalig wachtwoord: ”
},
{
“Language”: “pl”,
“Value”: “Podpisz dokument związany z identyfikatorem IDTransakcji {tId}, korzystając z OTP: ”
},
{
“Language”: “pt-br”,
“Value”: “Por favor, assine o documento de ID {tId} utilizando o OTP (One Time Password): ”
},
{
“Language”: “pt-pt”,
“Value”: “Assine o documento, referenciado pela ID de transação {tId}, usando o OTP: ”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa semnati documentul, la care se face referinta prin ID-ul de tranzactie {tId}, folosind OTP-ul: ”
},
{
“Language”: “zh-cn”,
“Value”: “请签署文件,请引用事务标识号{tId},并使用OTP:”
}
]
},
{
“Id”: “otpSignatureSmsText”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Value”: “Please sign the document with the transactionId {tId} with the code: {Token} ”
},
{
“Language”: “bg”,
“Value”: “Моля, подпишете документа с Id {tId} на транзакцията с код: {Token} ”
},
{
“Language”: “de”,
“Value”: “Bitte signieren Sie das Dokument, referenziert durch die Transaktions {tId}, mit dem Einmalpasswort: {Token} ”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε υπογράψτε το έγγραφο με αναφορά τον αναγνωριστικό κωδικό συναλλαγής {tId}, χρησιμοποιώντας τον κωδικό: {Token} ”
},
{
“Language”: “en”,
“Value”: “Please sign the document with the transactionId {tId} with the code: {Token} ”
},
{
“Language”: “es”,
“Value”: “Firme el documento con ID de transacción {tId}, usando el código: {Token} ”
},
{
“Language”: “fr”,
“Value”: “Veuillez signer le document avec l’identifiant de transaction {tId} avec le code : {Token} ”
},
{
“Language”: “it”,
“Value”: “Firma il documento, con riferimento alla transazione {tId}, usando il codice OTP {Token} ”
},
{
“Language”: “nl”,
“Value”: “Onderteken het document met transactie-ID {tId}, met code: {Token} ”
},
{
“Language”: “pl”,
“Value”: “Podpisz dokument związany z identyfikatorem IDTransakcji {tId}, korzystając z kodu: {Token} ”
},
{
“Language”: “pt-br”,
“Value”: “Por favor, assine o documento de ID {tId} utilizando o código: {Token} ”
},
{
“Language”: “pt-pt”,
“Value”: “Assine o documento com a ID de transação {tId} com o código: {Token} ”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa semnati documentul ce contine transactionId {tId} cu codul {Token} ”
},
{
“Language”: “zh-cn”,
“Value”: “请使用事务标识号{tId}与密码:{Token}签署文件。”
}
]
},
{
“Id”: “swissComSign”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Value”: “Please confirm to sign the document”
},
{
“Language”: “bg”,
“Value”: “Моля, потвърдете, за да подпишете документа”
},
{
“Language”: “de”,
“Value”: “Bitte bestätigen sie die Unterschrift des Dokuments”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε επιβεβαιώστε για να υπογράψετε το έγγραφο”
},
{
“Language”: “en”,
“Value”: “Please confirm to sign the document”
},
{
“Language”: “es”,
“Value”: “Confirme la firma del documento”
},
{
“Language”: “fr”,
“Value”: “Veuillez confirmer de signer le document”
},
{
“Language”: “it”,
“Value”: “Si prega di confermare per firmare il documento”
},
{
“Language”: “nl”,
“Value”: “Gelieve te bevestigen om het document te ondertekenen”
},
{
“Language”: “pl”,
“Value”: “Potwierdź w celu podpisania dokumentu”
},
{
“Language”: “pt-br”,
“Value”: “Por favor confirme a assinatura do documento”
},
{
“Language”: “pt-pt”,
“Value”: “Confirme para assinar o documento”
},
{
“Language”: “ro”,
“Value”: “Confirmați să semnați documentul”
},
{
“Language”: “zh-cn”,
“Value”: “请确认以签署此文档”
}
]
}
],
“SignatureConfigurations”: [],
“ViewerPreferences”: {
“FinishWorkstepOnOpen”: false,
“VisibleAreaOptions”: {
“AllowedDomain”: “*”,
“Enabled”: false
}
},
“ResourceUris”: {
“DelegationUri”: “https://demo3.local//Resource/Delegate”
},
“AuditingToolsConfiguration”: {
“WriteAuditTrail”: true,
“NotificationConfiguration”: {}
},
“Policy”: {
“GeneralPolicies”: {
“AllowSaveDocument”: true,
“AllowSaveAuditTrail”: true,
“AllowRotatingPages”: false,
“AllowEmailDocument”: true,
“AllowPrintDocument”: true,
“AllowFinishWorkstep”: true,
“AllowRejectWorkstep”: true,
“AllowRejectWorkstepDelegation”: true,
“AllowUndoLastAction”: false,
“AllowAdhocPdfAttachments”: false,
“AllowAdhocSignatures”: false,
“AllowAdhocStampings”: false,
“AllowAdhocFreeHandAnnotations”: false,
“AllowAdhocTypewriterAnnotations”: false,
“AllowAdhocPictureAnnotations”: false,
“AllowAdhocPdfPageAppending”: false
},
“WorkstepTasks”: {
“PictureAnnotationMinResolution”: 0,
“PictureAnnotationMaxResolution”: 0,
“PictureAnnotationColorDepth”: “Color16M”,
“SequenceMode”: “NoSequenceEnforced”,
“PositionUnits”: “PdfUnits”,
“ReferenceCorner”: “Lower_Left”,
“Tasks”: [
{
“PositionPage”: 1,
“Position”: {
“PositionX”: 61.0,
“PositionY”: 586.0
},
“Size”: {
“Height”: 80.0,
“Width”: 191.0
},
“AdditionalParameters”: [
{
“Key”: “enabled”,
“Value”: “1”
},
{
“Key”: “positioning”,
“Value”: “onPage”
},
{
“Key”: “req”,
“Value”: “1”
},
{
“Key”: “fd”,
“Value”: “”
},
{
“Key”: “fd_dateformat”,
“Value”: “dd-MM-yyyy HH:mm:ss”
},
{
“Key”: “fd_timezone”,
“Value”: “datetimeutc”
}
],
“AllowedSignatureTypes”: [
{
“AllowedCapturingMethod”: “Click2Sign”,
“StampImprintConfiguration”: {
“DisplayExtraInformation”: true,
“DisplayEmail”: true,
“DisplayIp”: true,
“DisplayName”: true,
“DisplaySignatureDate”: true,
“FontFamily”: “Times New Roman”,
“FontSize”: 11.0
},
“Id”: “4657c69c-b2e6-4bfc-9118-4aff655418b5”,
“DiscriminatorType”: “SigTypeClick2Sign”,
“Preferred”: false
}
],
“IsRequired”: true,
“Id”: “1#XyzmoDuplicateIdSeperator#Signature_7bfa129e-53d6-0e91-e919-71f756277154”,
“DisplayName”: “”,
“DocRefNumber”: 1,
“DiscriminatorType”: “Signature”
}
]
}
}
},
“DocumentOptions”: [
{
“DocumentReference”: “1”,
“IsHidden”: false
}
],
“UseDefaultAgreements”: false
},
{
“OrderIndex”: 2,
“Recipients”: [
{
“Email”: “EMAILADDRESS”,
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“LanguageCode”: “de”,
“EmailBodyExtra”: “”,
“DisableEmail”: false,
“AddAndroidAppLink”: false,
“AddIosAppLink”: false,
“AddWindowsAppLink”: false,
“AllowDelegation”: false,
“SkipExternalDataValidation”: false,
“AuthenticationMethods”: []
}
],
“EmailBodyExtra”: “”,
“RecipientType”: “Cc”,
“DocumentOptions”: [
{
“DocumentReference”: “1”,
“IsHidden”: false
}
],
“UseDefaultAgreements”: false
}
],
“AddFormFields”: {
“Forms”: {}
},
“OverrideFormFieldValues”: {
“Forms”: {}
},
“AttachSignedDocumentsToEnvelopeLog”: false
}
}

{
“EnvelopeId”: “d4f71aec-e332-48c3-8ca9-b0be6adf9ea8”
}

Get the envelope description

The last request of this tutorial will be the download of the document which has been signed.

But before we will check if the envelope with the ID which we got from the sending is correct. Furthermore, we need the request “get the envelope” because of the document ID`s which we only get because of this request.

The following Figure will help you with the request and give you an overview how it should be done.

Figure 7: Envelope description

{
“Status”: “InProgress”,
“SendDate”: “2019-06-25T13:03:18.043Z”,
“ExpirationDate”: “2019-07-23T13:03:18.043”,
“Bulks”: [
{
“Status”: “InProgress”,
“Email”: “”,
“LogDocumentId”: “”,
“FinishedDocuments”: [],
“Steps”: [
{
“Id”: “53637745-5051-4ea7-b6de-8ee00cf24559”,
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“OrderIndex”: 1,
“Email”: “EMAILADDRESS”,
“LanguageCode”: “de”,
“Status”: “NotSigned”,
“StatusReason”: “”,
“RecipientType”: “Signer”,
“WorkstepRedirectionUrl”: “https://demo.xyzmo.com/workstepredirector/sign?identifier=3XLAHD0LZaGs4X06NcNfV0IaVWvUDiCHKbhJ8Lmi9RO6PZjKZPWRKH3qt7A31acXgVi0h~1yFdvfuSZCF0CsYw==”,
“IsParallel”: false,
“WorkstepConfiguration”: {
“WorkstepLabel”: “Download”,
“SmallTextZoomFactorPercent”: 100,
“FinishAction”: {
“ServerActions”: [
{
“CallSynchronous”: false,
“Action”: “https://demo3.local//workstepredirector/setfinishaction?wid=##WorkstepId##”
}
],
“ClientActions”: []
},
“ReceiverInformation”: {
“UserInformation”: {
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“EMail”: “EMAILADDRESS”
}
},
“SenderInformation”: {
“UserInformation”: {
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“EMail”: “EMAILADDRESS”
}
},
“TransactionCodeConfigurations”: [
{
“Id”: “smsAuthTransactionCodeId”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Language”: “”,
“Value”: “Please authenticate yourself for the access to the envelope with the transactionId {tId}. Your code is: {Token}”
},
{
“Language”: “bg”,
“Value”: “Моля, удостоверете се за достъп до плика с Id {tId} на трансакцията. Вашият код е: {Token}”
},
{
“Language”: “de”,
“Value”: “Bitte authentifizieren Sie sich für den Zugriff auf die Dokumentenmappe der Transaktion {tId}. Ihre TAN lautet: {Token}”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε ταυτοποιηθείτε για την πρόσβαση στον φάκελο με τον αναγνωριστικό κωδικό συναλλαγής {tId}. Ο κωδικός σας είναι: {Token}”
},
{
“Language”: “en”,
“Value”: “Please authenticate yourself for the access to the envelope with the transactionId {tId}. Your code is: {Token}”
},
{
“Language”: “es”,
“Value”: “Autentíquese para acceder al sobre con el ID de transacción {tId}. Su código es: {Token}”
},
{
“Language”: “fr”,
“Value”: “Veuillez vous authentifier afin d’accéder à l’enveloppe avec l’identifiant de transaction {tId}. Votre code est : {Token}”
},
{
“Language”: “it”,
“Value”: “Con riferimento alla transazione {tId}, per autenticarsi si prega di inserire il seguente CODICE {Token}”
},
{
“Language”: “nl”,
“Value”: “U dient zich te authenticeren voor toegang tot enveloppe met transactie-ID {tId}. Uw code is: {Token}”
},
{
“Language”: “pl”,
“Value”: “Dokonaj uwierzytelnienia, aby uzyskać dostęp do koperty z identyfikatorem IDTransakcji {tId}. Twój kod to: {Token}”
},
{
“Language”: “pt-br”,
“Value”: “Por favor autentique-se para acessar ao envelope com o ID: {tId}. Seu código é: {Token}”
},
{
“Language”: “pt-pt”,
“Value”: “Autentique-se para aceder ao envelope com a ID de transação {tId}. O seu código é: {Token}”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa va autentificati pentru accesul la documentul cu numarul de tranzactie {tId}. Codul este: {Token}. ”
},
{
“Language”: “zh-cn”,
“Value”: “请使用事务标识号{tId}验证自己的身分以便访问此信封。您的密码是:{Token}”
}
]
},
{
“Id”: “disposableCertificateEnrolAndSignSmsText”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Language”: “”,
“Value”: “Please confirm the issuance of your disposable certificate and signature, referenced by transactionId {tId}, with the OTP: ”
},
{
“Language”: “bg”,
“Value”: “Моля, потвърдете издаването на Вашия сертификат за еднократна употреба, отнасящ се до Id {tId} на трансакцията, подпишете с OTP: ”
},
{
“Language”: “de”,
“Value”: “Bitte bestätigen Sie die Ausstellung des Einwegzertifikats und die Signatur für Transaktion {tId} mit dem Einmalpasswort: ”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε επιβεβαιώστε την έκδοση του πιστοποιητικού και υπογραφής μίας χρήσης, με αναφορά το Id συναλλαγής {tId}, με το OTP: ”
},
{
“Language”: “en”,
“Value”: “Please confirm the issuance of your disposable certificate and signature, referenced by transactionId {tId}, with the OTP: ”
},
{
“Language”: “es”,
“Value”: “Confirme la emisión de su firma y certificado desechable, a los que se hace referencia por el ID de transacción {tId}, con el OTP: ”
},
{
“Language”: “fr”,
“Value”: “Veuillez confirmer la délivrance de votre signature et certificat référencé par l’identifiant {tId} avec le mot de passe à usage unique : ”
},
{
“Language”: “it”,
“Value”: “Conferma l’emissione del tuo certificato disposable, con riferimento alla transazione {tId}, e della firma con l´OTP ”
},
{
“Language”: “nl”,
“Value”: “Bevestig de afgifte van uw eenmalig certificaat en handtekening, met transactie-ID {tId} en het eenmalig wachtwoord: ”
},
{
“Language”: “pl”,
“Value”: “Potwierdź wydanie jednorazowego certyfikatu i podpisu w związku z transakcją o numerze {tId}, korzystając z OTP: ”
},
{
“Language”: “pt-br”,
“Value”: “Por favor, confirme a emissão do seu certificado e assinatura descartáveis, referenciados por {tId}, com o OTP: ”
},
{
“Language”: “pt-pt”,
“Value”: “Confirme a emissão do seu certificado disponível e a assinatura, referenciado pela ID de transação {tId}, com o OTP: ”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa confirmati emiterea certificatului de unica folosinta si a semnaturii, referitor la numarul de tranzactie {tId}, cu OTP-ul: ”
},
{
“Language”: “zh-cn”,
“Value”: “请确认签发单次性证书和签名,请引用事务标识号{tId},与OTP:”
}
]
},
{
“Id”: “remoteCertificateSignSmsText”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Language”: “”,
“Value”: “Please sign the document, referenced by transactionId {tId}, using the OTP: ”
},
{
“Language”: “bg”,
“Value”: “Моля, подпишете документа, отнасящ се до Id {tId} на трансакцията, като използвате OTP: ”
},
{
“Language”: “de”,
“Value”: “Bitte signieren Sie das Dokument, referenziert durch die Transaktions {tId}, mit dem Einmalpasswort: ”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε υπογράψτε το έγγραφο με αναφορά τον αναγνωριστικό κωδικό συναλλαγής {tId}, χρησιμοποιώντας το OTP: ”
},
{
“Language”: “en”,
“Value”: “Please sign the document, referenced by transactionId {tId}, using the OTP: ”
},
{
“Language”: “es”,
“Value”: “Firme el documento, al que se hace referencia por el ID de transacción {tId}, usando el OTP: ”
},
{
“Language”: “fr”,
“Value”: “Veuillez signer le document, référencé par l’identifiant de transaction {tId}, en utilisant le mot de passe à usage unique : ”
},
{
“Language”: “it”,
“Value”: “Firma il documento, con riferimento alla transazione {tId}, usando l´OTP ”
},
{
“Language”: “nl”,
“Value”: “Onderteken het document met transactie-ID {tId}, met behulp van het eenmalig wachtwoord: ”
},
{
“Language”: “pl”,
“Value”: “Podpisz dokument związany z identyfikatorem IDTransakcji {tId}, korzystając z OTP: ”
},
{
“Language”: “pt-br”,
“Value”: “Por favor, assine o documento de ID {tId} utilizando o OTP (One Time Password): ”
},
{
“Language”: “pt-pt”,
“Value”: “Assine o documento, referenciado pela ID de transação {tId}, usando o OTP: ”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa semnati documentul, la care se face referinta prin ID-ul de tranzactie {tId}, folosind OTP-ul: ”
},
{
“Language”: “zh-cn”,
“Value”: “请签署文件,请引用事务标识号{tId},并使用OTP:”
}
]
},
{
“Id”: “otpSignatureSmsText”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Language”: “”,
“Value”: “Please sign the document with the transactionId {tId} with the code: {Token} ”
},
{
“Language”: “bg”,
“Value”: “Моля, подпишете документа с Id {tId} на транзакцията с код: {Token} ”
},
{
“Language”: “de”,
“Value”: “Bitte signieren Sie das Dokument, referenziert durch die Transaktions {tId}, mit dem Einmalpasswort: {Token} ”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε υπογράψτε το έγγραφο με αναφορά τον αναγνωριστικό κωδικό συναλλαγής {tId}, χρησιμοποιώντας τον κωδικό: {Token} ”
},
{
“Language”: “en”,
“Value”: “Please sign the document with the transactionId {tId} with the code: {Token} ”
},
{
“Language”: “es”,
“Value”: “Firme el documento con ID de transacción {tId}, usando el código: {Token} ”
},
{
“Language”: “fr”,
“Value”: “Veuillez signer le document avec l’identifiant de transaction {tId} avec le code : {Token} ”
},
{
“Language”: “it”,
“Value”: “Firma il documento, con riferimento alla transazione {tId}, usando il codice OTP {Token} ”
},
{
“Language”: “nl”,
“Value”: “Onderteken het document met transactie-ID {tId}, met code: {Token} ”
},
{
“Language”: “pl”,
“Value”: “Podpisz dokument związany z identyfikatorem IDTransakcji {tId}, korzystając z kodu: {Token} ”
},
{
“Language”: “pt-br”,
“Value”: “Por favor, assine o documento de ID {tId} utilizando o código: {Token} ”
},
{
“Language”: “pt-pt”,
“Value”: “Assine o documento com a ID de transação {tId} com o código: {Token} ”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa semnati documentul ce contine transactionId {tId} cu codul {Token} ”
},
{
“Language”: “zh-cn”,
“Value”: “请使用事务标识号{tId}与密码:{Token}签署文件。”
}
]
},
{
“Id”: “swissComSign”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Language”: “”,
“Value”: “Please confirm to sign the document”
},
{
“Language”: “bg”,
“Value”: “Моля, потвърдете, за да подпишете документа”
},
{
“Language”: “de”,
“Value”: “Bitte bestätigen sie die Unterschrift des Dokuments”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε επιβεβαιώστε για να υπογράψετε το έγγραφο”
},
{
“Language”: “en”,
“Value”: “Please confirm to sign the document”
},
{
“Language”: “es”,
“Value”: “Confirme la firma del documento”
},
{
“Language”: “fr”,
“Value”: “Veuillez confirmer de signer le document”
},
{
“Language”: “it”,
“Value”: “Si prega di confermare per firmare il documento”
},
{
“Language”: “nl”,
“Value”: “Gelieve te bevestigen om het document te ondertekenen”
},
{
“Language”: “pl”,
“Value”: “Potwierdź w celu podpisania dokumentu”
},
{
“Language”: “pt-br”,
“Value”: “Por favor confirme a assinatura do documento”
},
{
“Language”: “pt-pt”,
“Value”: “Confirme para assinar o documento”
},
{
“Language”: “ro”,
“Value”: “Confirmați să semnați documentul”
},
{
“Language”: “zh-cn”,
“Value”: “请确认以签署此文档”
}
]
}
],
“SignatureConfigurations”: [
{
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: false,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “DoNotInclude”
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “timestampSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: false,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “DoNotInclude”,
“SignatureTimestampData”: {
“Uri”: “https://timestamp.test.namirialtsp.com”,
“Username”: “xyzmo”,
“Password”: “xyzmo”,
“SignatureHashAlgorithm”: “Sha256”
}
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “padesSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: true,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “IncludeDss”
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “padesTimestampSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: true,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “IncludeDss”,
“SignatureTimestampData”: {
“Uri”: “https://timestamp.test.namirialtsp.com”,
“Username”: “xyzmo”,
“Password”: “xyzmo”,
“SignatureHashAlgorithm”: “Sha256”
}
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “automaticSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: false,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “DoNotInclude”
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “automaticTimestampSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: false,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “DoNotInclude”,
“SignatureTimestampData”: {
“Uri”: “https://timestamp.test.namirialtsp.com”,
“Username”: “xyzmo”,
“Password”: “xyzmo”,
“SignatureHashAlgorithm”: “Sha256”
}
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “swissComSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: true,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “IncludeDss”
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
}
],
“ViewerPreferences”: {
“FinishWorkstepOnOpen”: false,
“VisibleAreaOptions”: {
“AllowedDomain”: “*”,
“Enabled”: false
}
},
“AdditionalClientWorkstepInformation”: “”,
“Policy”: {
“GeneralPolicies”: {
“AllowSaveDocument”: true,
“AllowSaveAuditTrail”: true,
“AllowRotatingPages”: false,
“AllowAppendFileToWorkstep”: false,
“AllowAppendTaskToWorkstep”: false,
“AllowEmailDocument”: true,
“AllowPrintDocument”: true,
“AllowFinishWorkstep”: true,
“AllowRejectWorkstep”: true,
“AllowRejectWorkstepDelegation”: true,
“AllowUndoLastAction”: false,
“AllowColorizePdfForms”: false,
“AllowAdhocPdfAttachments”: false,
“AllowAdhocSignatures”: false,
“AllowAdhocStampings”: false,
“AllowAdhocFreeHandAnnotations”: false,
“AllowAdhocTypewriterAnnotations”: false,
“AllowAdhocPictureAnnotations”: false,
“AllowAdhocPdfPageAppending”: false
},
“WorkstepTasks”: {
“PictureAnnotationMinResolution”: 0,
“PictureAnnotationMaxResolution”: 0,
“PictureAnnotationColorDepth”: “Color16M”,
“SequenceMode”: “NoSequenceEnforced”,
“PositionUnits”: “PdfUnits”,
“ReferenceCorner”: “Lower_Left”,
“Tasks”: [
{
“PositionPage”: 1,
“Position”: {
“PositionX”: 61,
“PositionY”: 586
},
“Size”: {
“Height”: 80,
“Width”: 191
},
“AdditionalParameters”: [
{
“Key”: “enabled”,
“Value”: “1”
},
{
“Key”: “positioning”,
“Value”: “onPage”
},
{
“Key”: “req”,
“Value”: “1”
},
{
“Key”: “fd”,
“Value”: “”
},
{
“Key”: “fd_dateformat”,
“Value”: “dd-MM-yyyy HH:mm:ss”
},
{
“Key”: “fd_timezone”,
“Value”: “datetimeutc”
}
],
“AllowedSignatureTypes”: [
{
“AllowedCapturingMethod”: “Click2Sign”,
“StampImprintConfiguration”: {
“DisplayExtraInformation”: true,
“DisplayEmail”: true,
“DisplayIp”: true,
“DisplayName”: true,
“DisplaySignatureDate”: true,
“FontFamily”: “Times New Roman”,
“FontSize”: 11
},
“Id”: “4657c69c-b2e6-4bfc-9118-4aff655418b5”,
“DiscriminatorType”: “SigTypeClick2Sign”,
“Preferred”: false
}
],
“IsRequired”: true,
“Id”: “1#XyzmoDuplicateIdSeperator#Signature_7bfa129e-53d6-0e91-e919-71f756277154”,
“DisplayName”: “”,
“DocRefNumber”: 1,
“DiscriminatorType”: “Signature”
}
]
}
}
}
},
{
“Id”: “58ef1882-e773-47c1-9367-2cecb4870ef1”,
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“OrderIndex”: 2,
“Email”: “EMAILADDRESS”,
“LanguageCode”: “de”,
“Status”: “NotSigned”,
“StatusReason”: “”,
“RecipientType”: “Cc”,
“WorkstepRedirectionUrl”: “”,
“IsParallel”: false,
“WorkstepConfiguration”: {
“SmallTextZoomFactorPercent”: 100,
“ViewerPreferences”: {},
“Policy”: {
“GeneralPolicies”: {
“AllowRotatingPages”: true,
“AllowFinishWorkstep”: true,
“AllowUndoLastAction”: true
},
“WorkstepTasks”: {
“PictureAnnotationMinResolution”: 0,
“PictureAnnotationMaxResolution”: 0,
“PictureAnnotationColorDepth”: “Color16M”,
“SequenceMode”: “NoSequenceEnforced”,
“PositionUnits”: “PdfUnits”,
“ReferenceCorner”: “Lower_Left”,
“Tasks”: []
}
}
}
}
]
}
],
“Documents”: [
{
“PageSizesInPoints”: [
{
“Height”: 841.92,
“Width”: 595.31999999999994
}
],
“DocRefNumber”: 1,
“FileName”: “eSignAnyWhere_Tutorial.pdf”,
“FormFields”: []
}
],
“Id”: “d4f71aec-e332-48c3-8ca9-b0be6adf9ea8”,
“Bulk”: “”,
“BasicOptions”: {
“Name”: “example”,
“EmailSubject”: “Please sign the enclosed envelope”,
“EmailBody”: “Dear #RecipientFirstName# #RecipientLastName#\n#PersonalMessage#\nPlease sign the envelope #EnvelopeName#\n\nEnvelope will expire at #ExpirationDate#”,
“EnableReminders”: true,
“FirstReminderDayAmount”: 5,
“RecurrentReminderDayAmount”: 3,
“BeforeExpirationDayAmount”: 3,
“DaysUntilExpire”: 28
}
}

In Figure 7 you can see that you just have to do the authorization as usual and you have to attach your envelope ID to the URL. In the result we can see that the status is in progress so the one who got the envelope has not signed yet.

If we do the same request after the recipient has signed the envelope, we will get the result which is shown in Figure 8.

Figure 8: Get signed envelope

{
“Status”: “Completed”,
“SendDate”: “2019-06-25T13:03:18.043Z”,
“ExpirationDate”: “2019-07-23T13:03:18.043”,
“Bulks”: [
{
“Status”: “Completed”,
“Email”: “”,
“LogDocumentId”: “6b855fca-1e57-401c-b56c-263543713719”,
“LogXmlDocumentId”: “ab969d2a-27d7-4a53-97b6-7e730e9db158”,
“FinishedDocuments”: [
{
“FlowDocumentId”: “b7d26569-5206-4609-b99e-78d6bf372e59”,
“LogDocumentId”: “”,
“Attachments”: [],
“SignedSignatureFields”: [
{
“Name”: “Signature_7bfa129e-53d6-0e91-e919-71f756277154”
}
],
“DocRefNumber”: 1,
“FileName”: “eSignAnyWhere_Tutorial.pdf”,
“FormFields”: []
}
],
“Steps”: [
{
“Id”: “53637745-5051-4ea7-b6de-8ee00cf24559”,
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“OrderIndex”: 1,
“Email”: “EMAILADDRESS”,
“LanguageCode”: “de”,
“Status”: “Signed”,
“StatusReason”: “”,
“RecipientType”: “Signer”,
“SignedDate”: “2019-06-25T13:21:26.157Z”,
“WorkstepRedirectionUrl”: “”,
“IsParallel”: false,
“WorkstepConfiguration”: {
“WorkstepLabel”: “Download”,
“SmallTextZoomFactorPercent”: 100,
“FinishAction”: {
“ServerActions”: [
{
“CallSynchronous”: false,
“Action”: “https://demo3.local//workstepredirector/setfinishaction?wid=##WorkstepId##”
}
],
“ClientActions”: []
},
“ReceiverInformation”: {
“UserInformation”: {
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“EMail”: “EMAILADDRESS”
}
},
“SenderInformation”: {
“UserInformation”: {
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“EMail”: “EMAILADDRESS”
}
},
“TransactionCodeConfigurations”: [
{
“Id”: “smsAuthTransactionCodeId”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Language”: “”,
“Value”: “Please authenticate yourself for the access to the envelope with the transactionId {tId}. Your code is: {Token}”
},
{
“Language”: “bg”,
“Value”: “Моля, удостоверете се за достъп до плика с Id {tId} на трансакцията. Вашият код е: {Token}”
},
{
“Language”: “de”,
“Value”: “Bitte authentifizieren Sie sich für den Zugriff auf die Dokumentenmappe der Transaktion {tId}. Ihre TAN lautet: {Token}”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε ταυτοποιηθείτε για την πρόσβαση στον φάκελο με τον αναγνωριστικό κωδικό συναλλαγής {tId}. Ο κωδικός σας είναι: {Token}”
},
{
“Language”: “en”,
“Value”: “Please authenticate yourself for the access to the envelope with the transactionId {tId}. Your code is: {Token}”
},
{
“Language”: “es”,
“Value”: “Autentíquese para acceder al sobre con el ID de transacción {tId}. Su código es: {Token}”
},
{
“Language”: “fr”,
“Value”: “Veuillez vous authentifier afin d’accéder à l’enveloppe avec l’identifiant de transaction {tId}. Votre code est : {Token}”
},
{
“Language”: “it”,
“Value”: “Con riferimento alla transazione {tId}, per autenticarsi si prega di inserire il seguente CODICE {Token}”
},
{
“Language”: “nl”,
“Value”: “U dient zich te authenticeren voor toegang tot enveloppe met transactie-ID {tId}. Uw code is: {Token}”
},
{
“Language”: “pl”,
“Value”: “Dokonaj uwierzytelnienia, aby uzyskać dostęp do koperty z identyfikatorem IDTransakcji {tId}. Twój kod to: {Token}”
},
{
“Language”: “pt-br”,
“Value”: “Por favor autentique-se para acessar ao envelope com o ID: {tId}. Seu código é: {Token}”
},
{
“Language”: “pt-pt”,
“Value”: “Autentique-se para aceder ao envelope com a ID de transação {tId}. O seu código é: {Token}”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa va autentificati pentru accesul la documentul cu numarul de tranzactie {tId}. Codul este: {Token}. ”
},
{
“Language”: “zh-cn”,
“Value”: “请使用事务标识号{tId}验证自己的身分以便访问此信封。您的密码是:{Token}”
}
]
},
{
“Id”: “disposableCertificateEnrolAndSignSmsText”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Language”: “”,
“Value”: “Please confirm the issuance of your disposable certificate and signature, referenced by transactionId {tId}, with the OTP: ”
},
{
“Language”: “bg”,
“Value”: “Моля, потвърдете издаването на Вашия сертификат за еднократна употреба, отнасящ се до Id {tId} на трансакцията, подпишете с OTP: ”
},
{
“Language”: “de”,
“Value”: “Bitte bestätigen Sie die Ausstellung des Einwegzertifikats und die Signatur für Transaktion {tId} mit dem Einmalpasswort: ”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε επιβεβαιώστε την έκδοση του πιστοποιητικού και υπογραφής μίας χρήσης, με αναφορά το Id συναλλαγής {tId}, με το OTP: ”
},
{
“Language”: “en”,
“Value”: “Please confirm the issuance of your disposable certificate and signature, referenced by transactionId {tId}, with the OTP: ”
},
{
“Language”: “es”,
“Value”: “Confirme la emisión de su firma y certificado desechable, a los que se hace referencia por el ID de transacción {tId}, con el OTP: ”
},
{
“Language”: “fr”,
“Value”: “Veuillez confirmer la délivrance de votre signature et certificat référencé par l’identifiant {tId} avec le mot de passe à usage unique : ”
},
{
“Language”: “it”,
“Value”: “Conferma l’emissione del tuo certificato disposable, con riferimento alla transazione {tId}, e della firma con l´OTP ”
},
{
“Language”: “nl”,
“Value”: “Bevestig de afgifte van uw eenmalig certificaat en handtekening, met transactie-ID {tId} en het eenmalig wachtwoord: ”
},
{
“Language”: “pl”,
“Value”: “Potwierdź wydanie jednorazowego certyfikatu i podpisu w związku z transakcją o numerze {tId}, korzystając z OTP: ”
},
{
“Language”: “pt-br”,
“Value”: “Por favor, confirme a emissão do seu certificado e assinatura descartáveis, referenciados por {tId}, com o OTP: ”
},
{
“Language”: “pt-pt”,
“Value”: “Confirme a emissão do seu certificado disponível e a assinatura, referenciado pela ID de transação {tId}, com o OTP: ”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa confirmati emiterea certificatului de unica folosinta si a semnaturii, referitor la numarul de tranzactie {tId}, cu OTP-ul: ”
},
{
“Language”: “zh-cn”,
“Value”: “请确认签发单次性证书和签名,请引用事务标识号{tId},与OTP:”
}
]
},
{
“Id”: “remoteCertificateSignSmsText”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Language”: “”,
“Value”: “Please sign the document, referenced by transactionId {tId}, using the OTP: ”
},
{
“Language”: “bg”,
“Value”: “Моля, подпишете документа, отнасящ се до Id {tId} на трансакцията, като използвате OTP: ”
},
{
“Language”: “de”,
“Value”: “Bitte signieren Sie das Dokument, referenziert durch die Transaktions {tId}, mit dem Einmalpasswort: ”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε υπογράψτε το έγγραφο με αναφορά τον αναγνωριστικό κωδικό συναλλαγής {tId}, χρησιμοποιώντας το OTP: ”
},
{
“Language”: “en”,
“Value”: “Please sign the document, referenced by transactionId {tId}, using the OTP: ”
},
{
“Language”: “es”,
“Value”: “Firme el documento, al que se hace referencia por el ID de transacción {tId}, usando el OTP: ”
},
{
“Language”: “fr”,
“Value”: “Veuillez signer le document, référencé par l’identifiant de transaction {tId}, en utilisant le mot de passe à usage unique : ”
},
{
“Language”: “it”,
“Value”: “Firma il documento, con riferimento alla transazione {tId}, usando l´OTP ”
},
{
“Language”: “nl”,
“Value”: “Onderteken het document met transactie-ID {tId}, met behulp van het eenmalig wachtwoord: ”
},
{
“Language”: “pl”,
“Value”: “Podpisz dokument związany z identyfikatorem IDTransakcji {tId}, korzystając z OTP: ”
},
{
“Language”: “pt-br”,
“Value”: “Por favor, assine o documento de ID {tId} utilizando o OTP (One Time Password): ”
},
{
“Language”: “pt-pt”,
“Value”: “Assine o documento, referenciado pela ID de transação {tId}, usando o OTP: ”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa semnati documentul, la care se face referinta prin ID-ul de tranzactie {tId}, folosind OTP-ul: ”
},
{
“Language”: “zh-cn”,
“Value”: “请签署文件,请引用事务标识号{tId},并使用OTP:”
}
]
},
{
“Id”: “otpSignatureSmsText”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Language”: “”,
“Value”: “Please sign the document with the transactionId {tId} with the code: {Token} ”
},
{
“Language”: “bg”,
“Value”: “Моля, подпишете документа с Id {tId} на транзакцията с код: {Token} ”
},
{
“Language”: “de”,
“Value”: “Bitte signieren Sie das Dokument, referenziert durch die Transaktions {tId}, mit dem Einmalpasswort: {Token} ”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε υπογράψτε το έγγραφο με αναφορά τον αναγνωριστικό κωδικό συναλλαγής {tId}, χρησιμοποιώντας τον κωδικό: {Token} ”
},
{
“Language”: “en”,
“Value”: “Please sign the document with the transactionId {tId} with the code: {Token} ”
},
{
“Language”: “es”,
“Value”: “Firme el documento con ID de transacción {tId}, usando el código: {Token} ”
},
{
“Language”: “fr”,
“Value”: “Veuillez signer le document avec l’identifiant de transaction {tId} avec le code : {Token} ”
},
{
“Language”: “it”,
“Value”: “Firma il documento, con riferimento alla transazione {tId}, usando il codice OTP {Token} ”
},
{
“Language”: “nl”,
“Value”: “Onderteken het document met transactie-ID {tId}, met code: {Token} ”
},
{
“Language”: “pl”,
“Value”: “Podpisz dokument związany z identyfikatorem IDTransakcji {tId}, korzystając z kodu: {Token} ”
},
{
“Language”: “pt-br”,
“Value”: “Por favor, assine o documento de ID {tId} utilizando o código: {Token} ”
},
{
“Language”: “pt-pt”,
“Value”: “Assine o documento com a ID de transação {tId} com o código: {Token} ”
},
{
“Language”: “ro”,
“Value”: “Va rugam sa semnati documentul ce contine transactionId {tId} cu codul {Token} ”
},
{
“Language”: “zh-cn”,
“Value”: “请使用事务标识号{tId}与密码:{Token}签署文件。”
}
]
},
{
“Id”: “swissComSign”,
“HashAlgorithmIdentifier”: “Sha256”,
“Texts”: [
{
“Language”: “”,
“Value”: “Please confirm to sign the document”
},
{
“Language”: “bg”,
“Value”: “Моля, потвърдете, за да подпишете документа”
},
{
“Language”: “de”,
“Value”: “Bitte bestätigen sie die Unterschrift des Dokuments”
},
{
“Language”: “el”,
“Value”: “Παρακαλούμε επιβεβαιώστε για να υπογράψετε το έγγραφο”
},
{
“Language”: “en”,
“Value”: “Please confirm to sign the document”
},
{
“Language”: “es”,
“Value”: “Confirme la firma del documento”
},
{
“Language”: “fr”,
“Value”: “Veuillez confirmer de signer le document”
},
{
“Language”: “it”,
“Value”: “Si prega di confermare per firmare il documento”
},
{
“Language”: “nl”,
“Value”: “Gelieve te bevestigen om het document te ondertekenen”
},
{
“Language”: “pl”,
“Value”: “Potwierdź w celu podpisania dokumentu”
},
{
“Language”: “pt-br”,
“Value”: “Por favor confirme a assinatura do documento”
},
{
“Language”: “pt-pt”,
“Value”: “Confirme para assinar o documento”
},
{
“Language”: “ro”,
“Value”: “Confirmați să semnați documentul”
},
{
“Language”: “zh-cn”,
“Value”: “请确认以签署此文档”
}
]
}
],
“SignatureConfigurations”: [
{
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: false,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “DoNotInclude”
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “timestampSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: false,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “DoNotInclude”,
“SignatureTimestampData”: {
“Uri”: “https://timestamp.test.namirialtsp.com”,
“Username”: “xyzmo”,
“Password”: “xyzmo”,
“SignatureHashAlgorithm”: “Sha256”
}
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “padesSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: true,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “IncludeDss”
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “padesTimestampSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: true,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “IncludeDss”,
“SignatureTimestampData”: {
“Uri”: “https://timestamp.test.namirialtsp.com”,
“Username”: “xyzmo”,
“Password”: “xyzmo”,
“SignatureHashAlgorithm”: “Sha256”
}
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “automaticSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: false,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “DoNotInclude”
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “automaticTimestampSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: false,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “DoNotInclude”,
“SignatureTimestampData”: {
“Uri”: “https://timestamp.test.namirialtsp.com”,
“Username”: “xyzmo”,
“Password”: “xyzmo”,
“SignatureHashAlgorithm”: “Sha256”
}
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
},
{
“SpcId”: “swissComSigningId”,
“PdfSignatureProperties”: {
“PdfAConformant”: false,
“PAdESPart4Compliant”: true,
“IncludeSigningCertificateChain”: false,
“SigningCertificateRevocationInformationIncludeMode”: “IncludeDss”
},
“PdfSignatureCryptographicData”: {
“SignatureHashAlgorithm”: “Sha256”,
“SigningCertificateDescriptor”: {
“Identifier”: “14527a6bcfa8b4d7d0183fca6b735b1c246d14ae”,
“Type”: “Sha1Thumbprint”,
“Csp”: “Default”
}
}
}
],
“ViewerPreferences”: {
“FinishWorkstepOnOpen”: false,
“VisibleAreaOptions”: {
“AllowedDomain”: “*”,
“Enabled”: false
}
},
“AdditionalClientWorkstepInformation”: “”,
“Policy”: {
“GeneralPolicies”: {
“AllowSaveDocument”: true,
“AllowSaveAuditTrail”: true,
“AllowRotatingPages”: false,
“AllowAppendFileToWorkstep”: false,
“AllowAppendTaskToWorkstep”: false,
“AllowEmailDocument”: true,
“AllowPrintDocument”: true,
“AllowFinishWorkstep”: true,
“AllowRejectWorkstep”: true,
“AllowRejectWorkstepDelegation”: true,
“AllowUndoLastAction”: false,
“AllowColorizePdfForms”: false,
“AllowAdhocPdfAttachments”: false,
“AllowAdhocSignatures”: false,
“AllowAdhocStampings”: false,
“AllowAdhocFreeHandAnnotations”: false,
“AllowAdhocTypewriterAnnotations”: false,
“AllowAdhocPictureAnnotations”: false,
“AllowAdhocPdfPageAppending”: false
},
“WorkstepTasks”: {
“PictureAnnotationMinResolution”: 0,
“PictureAnnotationMaxResolution”: 0,
“PictureAnnotationColorDepth”: “Color16M”,
“SequenceMode”: “NoSequenceEnforced”,
“PositionUnits”: “PdfUnits”,
“ReferenceCorner”: “Lower_Left”,
“Tasks”: [
{
“PositionPage”: 1,
“Position”: {
“PositionX”: 61,
“PositionY”: 586
},
“Size”: {
“Height”: 80,
“Width”: 191
},
“AdditionalParameters”: [
{
“Key”: “enabled”,
“Value”: “1”
},
{
“Key”: “positioning”,
“Value”: “onPage”
},
{
“Key”: “req”,
“Value”: “1”
},
{
“Key”: “fd”,
“Value”: “”
},
{
“Key”: “fd_dateformat”,
“Value”: “dd-MM-yyyy HH:mm:ss”
},
{
“Key”: “fd_timezone”,
“Value”: “datetimeutc”
}
],
“AllowedSignatureTypes”: [
{
“AllowedCapturingMethod”: “Click2Sign”,
“StampImprintConfiguration”: {
“DisplayExtraInformation”: true,
“DisplayEmail”: true,
“DisplayIp”: true,
“DisplayName”: true,
“DisplaySignatureDate”: true,
“FontFamily”: “Times New Roman”,
“FontSize”: 11
},
“Id”: “4657c69c-b2e6-4bfc-9118-4aff655418b5”,
“DiscriminatorType”: “SigTypeClick2Sign”,
“Preferred”: false
}
],
“IsRequired”: true,
“Id”: “1#XyzmoDuplicateIdSeperator#Signature_7bfa129e-53d6-0e91-e919-71f756277154”,
“DisplayName”: “”,
“DocRefNumber”: 1,
“DiscriminatorType”: “Signature”
}
]
}
}
}
},
{
“Id”: “58ef1882-e773-47c1-9367-2cecb4870ef1”,
“FirstName”: “NAME”,
“LastName”: “LASTNAME”,
“OrderIndex”: 2,
“Email”: “EMAILADDRESS”,
“LanguageCode”: “de”,
“Status”: “Signed”,
“StatusReason”: “”,
“RecipientType”: “Cc”,
“SignedDate”: “2019-06-25T13:21:26.62Z”,
“WorkstepRedirectionUrl”: “”,
“IsParallel”: false,
“WorkstepConfiguration”: {
“SmallTextZoomFactorPercent”: 100,
“ViewerPreferences”: {},
“Policy”: {
“GeneralPolicies”: {
“AllowRotatingPages”: true,
“AllowFinishWorkstep”: true,
“AllowUndoLastAction”: true
},
“WorkstepTasks”: {
“PictureAnnotationMinResolution”: 0,
“PictureAnnotationMaxResolution”: 0,
“PictureAnnotationColorDepth”: “Color16M”,
“SequenceMode”: “NoSequenceEnforced”,
“PositionUnits”: “PdfUnits”,
“ReferenceCorner”: “Lower_Left”,
“Tasks”: []
}
}
}
}
]
}
],
“Documents”: [
{
“PageSizesInPoints”: [
{
“Height”: 841.92,
“Width”: 595.31999999999994
}
],
“DocRefNumber”: 1,
“FileName”: “eSignAnyWhere_Tutorial.pdf”,
“FormFields”: []
}
],
“Id”: “d4f71aec-e332-48c3-8ca9-b0be6adf9ea8”,
“Bulk”: “”,
“BasicOptions”: {
“Name”: “example”,
“EmailSubject”: “Please sign the enclosed envelope”,
“EmailBody”: “Dear #RecipientFirstName# #RecipientLastName#\n#PersonalMessage#\nPlease sign the envelope #EnvelopeName#\n\nEnvelope will expire at #ExpirationDate#”,
“EnableReminders”: true,
“FirstReminderDayAmount”: 5,
“RecurrentReminderDayAmount”: 3,
“BeforeExpirationDayAmount”: 3,
“DaysUntilExpire”: 28
}
}

In this case the status says completed so we have now the document ID`s which we need to download the signed document.

 

 

Download the signed document

The request to download the signed document is quite easy. You must attach the document ID which we got from the “get the envelope” request to the URL.

The next Figure will give you an overview.

Figure 9: Download

Download Request JSON

not required

Download Response JSON

Should response 200 OK

Attention: You can choose between three document ID`s which you got from the “get the envelope” request.

For the “LogDocumentId” you get an Audit, for the “LogXmlDocumentId” you get an XML and for the “FlowDocumentId” you get the original document with the sign of the recipient.

After the tutorial you should have the same requests which are shown in the next Figure.

Figure 10: All requests

How to use variables in Postman

Let us start with the authorization but this time we will use variables, so we do not have to remember the organization key and the user name for all other requests.

Manage environments

Figure 11: Create an environment variable

After selecting the configuration button which is shown in Figure 11 another window should appear which is shown in Figure 12. There you must give the environment a name and we have to create the two variables which are necessary for the authorization. Further details in the next Figure:

Figure 12: Fill in dates for environments

First give your two variables names (it does not matter how you name them). Then fill in “initial value” and “current value” your email address for the username and the organization key for the key. After filling up the environments for both variables, we now can use them in the header of the next request.

Authorization

Figure 13 shows you the same request we have already done in the tutorial above but this time we will use the variables we have just created.

Figure 13: Use of variables

In the first column we have our keys. In the second column we now do not have to fill in our email addresses and organizational keys, but we must write {{##name_of_the_variable##}}. From now on you can always use the variables instead of continual writing your address and your organizational key because all the dates are saved in the environments. If you run this request, you should get the status “200 OK”.

Upload a file

Now we will upload a file and save the file ID which we will get from the request in another variable in the environments.

Figure 14: Upload a file

Just these three lines of code are necessary to save the file ID in another variable.  First we will parse the response, then we set the file ID with the command (“pm.environment.set(“name_of_the_variable”, response.” name_of_the_response”).

After running this request, the new variable “sspFileId” should be in the environments. See next Figure:

Figure 15: sspFileId

Send an envelope

After saving the file id we can now send the envelope with an integration of the variable. Therefore we just fill in {{ name_of_the_variable_for_the_fileID}} instead of copy paste the file ID. This is shown in the next Figure. In the Figure 17 there is another example of how you save a date from the response. In this case we will save the envelope ID.

Figure 16: Send envelope

Figure 17: Save envelope ID

Get envelope description

Figure 18: Envelope description

We now want to save the different document ID`s (LogDocumentId, LogXmlDocumentId, FlowMDocumentId).

Therefore, we must check if the array has a length higher than 0. After that, we must do the same “set” command as in the previous once but now we have to “go” into the array. So we write again response.”name_of_the_array[on which place].”name_of_the_variable”.

Figure 19: Save document IDs

After we have saved all document ID`s we can use them for the download request.

Download the file

Therefore, we just have to attach the variable to the URL which is shown in the next Figure.

Figure 20: Download example

Overview of all variables

Figure 21: Overview

Advantages of using variables in Postman

First, we do not have to remember all dates which we get through all the requests. Furthermore, we can simply change the organization key and the username and wen can play all requests without other changes because the variables auto fill in the new dates in the requests. Moreover we have a better overview of all ID`s so that we can easily match them with the requirements of the requests.