Breadcrumbs

Get started with E-Signing Order Service (ESOS) REST API

E-Signing – ESOS REST API 

This Postman collection provides ready-to-use requests for integrating with the IN Groupe ESOS REST API. 

The collection covers the main resources used to compose and manage signing orders, including: 

  • Orders – Create and manage signing orders 

  • Documents – Add and manage documents to be signed 

  • Attachments – Add supporting documents that do not require signing 

  • Signers – Define the users who will sign documents 

  • Execution Details – Configure the rules and signing flow 

The collection includes an associated Postman Environment with the variables required to authenticate and execute the API requests. 

Authentication / Credentials 

To use the ESOS REST API, you need: 

  • Merchant ID (MID) 

  • Secret code / password 

Please contact IN Groupe Customer Support to obtain your Merchant ID and secret code. These credentials are customer-specific and should be stored securely in the Postman Environment. 

Do not publish or share the actual Merchant ID or secret code in the collection. Use environment variables for sensitive credentials. 

Getting Started 

  1. Download the Postman is not already downloaded. 

  1. Download the postman collections. 

 E-Signing Rest Environment.postman_environment.json

E-Signing Rest API.postman_collection.json

  1. Import this Postman collection. 

  1. Import the associated Postman Environment. 

  2. Select the environment in Postman. 

  1. Request your Merchant ID and Secret Code from IN Groupe Customer Support. 

  1. Add the credentials to the appropriate environment variables. 

Example: 

env = www.sign-preprod1.nets.eu 

merchantID = <your MerchantID> 

secretCode= <your SecretCode> 

  1. For your token endpoint: POST {{base_url}}/esos/token 

The Authorization header must use Basic Authentication, with the Merchant ID and Secret Code as the credentials. 

    Authorization: 

    Auth Type: Basic Auth 

    Username: {{merchantID}} 

    Password: {{secretCode}} 

  1.  Run the other requests to test the E-Signing integration. 

 

For additional information about the ESOS REST API and its resources, refer to the IN Groupe E-Signing API documentation.<link https://doc.ingroupe.com/developer/e-signing-apis >