Skip to main content

Customer-side eSign processing

All these operations need to be enabled for your account. They work on previously created orders. See Creating Orders for details.

If you desire a deeper integration of the signing process into your corporate design and want to provide the necessary function on your side, these functions will enable to you carry out the whole eSign process.

Process order and start signing​

Use this function to start the signing process. A TAN will be sent to the signee.

Requirements​

This function must be enabled for your account.

Method and URL​

[POST] https://customer.identity.tm/api/2.10/requestSign/[OrderID]

HTTP Codes​

202 Accepted

400 Bad request, error description in body

401 Authentication failed, please check username and password

404 Order not found or already deleted

406 Invalid order state

410 Order has already been processed

Example Request​

[POST] https://customer.identity.tm/api/2.10/requestSign/99920006C38842

Confirm signing​

Sign the document. To do so, the TAN previously sent need to be provided.

Requirements​

This function must be enabled for your account.

Method and URL​

[POST] https://customer.identity.tm/api/2.10/confirmSign/[OrderID]

JSON Request Body​

ElementParentTypeLenReqDescription
tan[ROOT]S6YThe TAN the user received.

HTTP Codes​

202 Accepted

400 Bad request, error description in body

401 Authentication failed, please check username and password

404 Order not found or already deleted

409 Wrong TAN given

410 Order has already been processed

412 Signing process has not been started, call requestSign first

429 Too many tries with a wrong TAN, order cancelled

Example Request​

[POST] https://customer.identity.tm/api/2.10/confirmSign/99920006C38842

{
  "tan": "123456"
}

Request a new TAN​

In case the TAN has not been received by the signee, you can request to send a new TAN to the signee.

Requirements​

This function must be enabled for your account.

Method and URL​

[POST] https://customer.identity.tm/api/2.10/requestResendSignTan/[OrderID]

HTTP Codes​

202 Accepted

400 Bad request, error description in body

401 Authentication failed, please check username and password

404 Order not found or already deleted

410 Order has already been processed

412 Signing process has not been started, call requestSign first

Example Request​

[POST] https://customer.identity.tm/api/2.10/requestResendSignTan/99920006C38842