Service Center

Envelope Management

Does the envelope sent by OpenAPI support preview in the draft state?

Envelopes created by uploading local files via OpenAPI do not support preview in draft status. To preview an envelope, please create it using an OpenAPI template and retrieve the preview file by calling the File Composition Task Details API (/esignglobal/v1/templates/renderTask).

 

 

Can OpenAPI query envelopes initiated via the Web UI?

No, the OpenAPI currently does not support querying envelopes initiated via the Web UI. However, the Web UI can query envelopes initiated via OpenAPI.

 

Can taskIdfileKey, and envelopeId be reused after a user cancels signing and restarts the process?

The fileKey can be reused. The purpose of the taskId is to retrieve the file, and since the file itself can be reused, there is no need to create a new one. However, the envelopeId cannot be reused.

 

Does eSignGlobal support automatic (silent) signing for signatures and seals?

eSignGlobal supports automatic (silent) triggering of the signing process for seals, eliminating the need for manual intervention. This feature is particularly useful for businesses handling large volumes of standardized contracts (e.g., employment agreements, supplier cooperation contracts), enabling batch processing to save significant time and labor.

To ensure compliance with evidentiary requirements, personal signatures must be manually applied and do not support automatic (silent) signing.

For silent signing, set the autoSign parameter to true when initiating the process via the OpenAPI (whether in a single-step or multi-step workflow).

For details, refer to the following interfaces:

        {
            "userEmail": "fengnian@tsign.cn",
            "userFirstName": "",
            "userLastName": "fengnian",
            "signOrder": 2,
            "autoSign": true, //静默签只支持图章,静默签需要传autoSign和stampId(图章ID的值)
            "signDateConfigs": [
                {
                    "posX": 200,
                    "posY": 765,
                    "pageNo": "1",
                    "signDateFormat": "yyyy-MM-dd"
                }
            ],
            "sealInfos": [
                {
                    "fileKey": "xxxxx",
                    "signConfigs": [
                        {
                            "fieldType": "stamp",
                            "posX": "455.61234",
                            "posY": "375.12186",
                            "pageNo": "1",
                            "width": 164,
                            "height": 162,
                            "stampId": "xxxxxxx"
                        }
                    ]
                }
            ]
        }

 

Does OpenAPI support specifying a stamp for signing?

  • No, OpenAPI does not support specifying a stamp for regular signing.
  • Only silent signing (autoSign=true + stampId) allows specifying a stamp.
  • For company/department stamps: The workspace admin must create the stamp first, and signers can then select it during signing.

 

Does the signer support using the seals of the company or department?

  1. If the signatory needs to use the seals of the company or department, the following two conditions need to be met: 1) It is necessary to first check whether the signatory and the initiator are under the same tenant. If not, the signatory can be invited to become a member under the same tenant in the member list and obtain the consent of the invitee.

添加成员-英文1.png
  1. It is necessary to check whether there are already created seals under this tenant. If there are no seals, the administrator needs to create them so that the signatory can choose to sign with the seals when signing.

添加图章-英文1.png

 

Does silent signing via OpenAPI support users from different workspaces?

No, silent signing fails if the participant and initiator are not from the same tenant.
Error: {"code":"120132","message":"The participant and initiator of the silent sign are not the same tenant"}

If you want to smoothly initiate a silent signature, you can invite the signer to become a member of the same workspace in the member list and obtain the consent of the invitee. Silent signing can only be sent normally when the sender and the signer are under the same workspace. For specific actions, you can refer to the following picture:

1.png

 

What’s the difference between "Anonymous Sign" and "Login Sign"?

  • Login Sign: Requires signing in to eSignGlobal when accessing the signing link (e.g., opening in a new browser).
  • Anonymous Sign: Allows direct access to the signing page via email link without login.

 

When initiating an envelope via OpenAPI, an error message {"code":"120142","message":"Signer XXX does not support enabling security mode for automatic signing."} will be reported.

Error when initiating an envelope with silent signing + security mode:

{"code":"120142","message":"Signer XXX does not support enabling security mode for automatic signing."}
Solution: Silent signing does not support identity verification—set authModes=0 or omit the parameter.

 

 

 

Signature/Stamp size mismatch in OpenAPI template envelopes

Compare the width/height/position returned by /esignglobal/v1/templates/renderTask with the values passed during envelope initiation. Adjust the API parameters to match the renderTask output.

 

 

After entering the password on the signing page of the mobile terminal, the message "It is recommended to upgrade, change the browser or try again after enabling the incognito mode." pops up.

  1. Confirm the access source before accessing: First, it is essential to determine whether the access is directly carried out within China or initiated directly from abroad.
  2. Responses to overseas access situations: ○ Method 1: Wait for a while and then refresh the page to try accessing again to see if the access can be carried out normally. ○ Method 2: Clear the cache of the browser first and then try the access operation again.
  3. Responses to domestic access situations: If the access is directly conducted within China, it should be noted that Cloudflare is used for human-machine verification. Due to the influence of the domestic network environment, direct access is usually rather unstable. Therefore, it is recommended to connect to a VPN first and then try accessing again to ensure the smooth progress of the access.
 

Can the signed files be deleted?

Regarding the deletion of signed files: Deletion operations are allowed.

Recommended deletion methods:

  • After the signing is completed, you can first download the signed files to local storage and then perform the deletion operation.
  • It is also possible to download all the signed files to local storage at regular intervals and then delete the corresponding files on the platform.

Matters needing attention: Be sure not to directly delete the files without downloading them to local storage. If you do so, you will not be able to download the signed files and the certification reports later.

 

The default language of the browser has been set to English, but when opening the signature page from an email, it still shows Chinese. How can this be resolved?

If the default language of the browser has been set to English, but the page still shows Chinese after opening the signature link in the email, it may be a display abnormality caused by the browser cache not being updated. The following steps are recommended:

  1. Clear the browser cache files (different browsers can quickly clear them through the settings menu or shortcut keys such as Ctrl + Shift + Delete).
  2. Close and restart the browser, and then reopen the signature link from the email.

This operation can forcibly refresh the page language configuration and usually can solve the problem of inconsistent language display caused by cache residues. If the problem persists, you can log in to the web terminal, switch the language, and then reopen the signature link, which will automatically switch to English. If there are still problems, you can further check whether the system language settings corresponding to the email link are synchronized with the browser language, or contact the platform technical support for assistance in troubleshooting.

 

What should be done if the envelopes initiated via OpenAPI cannot be found in the file list after logging in on the web side?

You can follow the following two steps to troubleshoot and solve the problem: Step 1: First, check whether the status of the envelope is in the draft state. If it is in the draft state, it means that the envelope has not been opened after being created, so it cannot be found in the file list. At this time, you need to call the interface for opening the envelope (/esignglobal/v1/envelope/start) to open the envelope. After completing this operation, you will be able to find the envelope in the file list. Step 2: If the envelope is already in the signing or completed state, but still cannot be found in the file list, then you can check whether the administrator's workspace is consistent with the workspace corresponding to the account that initiated the envelope via OpenAPI. If the two are inconsistent, the administrator will not be able to view the envelopes created via OpenAPI.

 

Does it support the reminder for envelopes that are about to expire? When will the reminder be sent?

It supports reminders for envelopes that are about to expire. When there is 1 day left before the envelope expires (that is, the day before it expires), a reminder that the envelope is about to expire will be sent via email. If the validity period of the envelope is less than 1 day, the reminder for the upcoming expiration will not be triggered.

 

 

Does eSignGlobal support corporate signers signing with both a stamp and a signature simultaneously?

Yes, it is supported. When creating an envelope, set up the stamp signing area and the signature signing area for the corporate signer. After the envelope is successfully initiated, the corporate signer can choose to apply both the stamp and the signature during the signing process.

 

If all signers have completed their signatures, but the ENVELOPE_ALL_SIGNER_SIGNED  callback event has not been triggered, what should the customer confirm?

The customer needs to confirm whether the envelope was initiated in a single-step or multi-step process. If it was a single-step envelope, the  ENVELOPE_ALL_SIGNER_SIGNED  callback event will be triggered automatically once all signers have completed their signatures. If it was a multi-step envelope, after all signers have completed their signatures, you need to call the "Finish Envelope" API (/esignglobal/v1/envelope/finish). The  ENVELOPE_ALL_SIGNER_SIGNED  callback event will then be triggered successfully.

 

How to adjust the coordinate position when using keywords to get the tag name?

To adjust the coordinates obtained via keywords, you can use the following adjustments:

y - (height of the signing area / 2)

x - (width of the signing area / 2)

 

When entering the passcode on the web signing page and clicking "Verify," the message "Network access is slow, please refresh the page and try again" appears. What could be the issue?

This might be due to a failed CAPTCHA verification. You can try refreshing the page or clearing your cache and then attempt the operation again.

 

How does eSignGlobal verify that a person and their email address are consistent?

eSignGlobal treats the signer's email address as a crucial form of identity verification. The logic is that if a user can successfully access the corresponding email inbox, it means they have control over that email, which, to some extent, indicates that the person and the email are consistent.

For example, when eSignGlobal sends an email containing the signing link to the signer, only the person who holds the email account's password can log in to the email and click the link to proceed with the signing process.

Furthermore, during the envelope creation process, eSignGlobal provides multiple other authentication methods to more comprehensively and rigorously verify the signer's identity. These include setting a passcode, where the signer sets a unique code to ensure the security and accuracy of the operation. Additionally, there are identity verification methods that use various professional identity verification tools to strictly identify the signer's true identity. Furthermore, convenient and reliable verification methods like iAM Smart are also included, providing signers with a variety of options to ensure the standardization and authenticity of the signing process.