This API is used to e-sign merchant agreements, and it is used while E-Sign PayU Service Agreement is generated and signed.

This API requires an access token using the Get Token API with the scope as EsignMergedDocument. For more information on getting the access token, refer to Get Token API.

📘
Prerequisite:
All KYC docs and website has to be in approved state for the merchant.

Environment


Test Environment	<https://uatoneapi.payu.in>
Production Environment	<https://oneapi.payu.in>

Request Headers

📘
Note:

The access token with the scope as EsignMergedDocument is required on the header. For more information on getting the access token, refer to Get Token API.

uuid value can be found in the response of the **Create Merchant ** API that must be used as the path parameter. For more information, refer to Create Merchant API.


Authorization	Bearer {{access_token}}
Content-Type	multipart/form-data

Request Parameters

Parameter	Description
otp mandatory	This parameter must include the OTP that is received by merchant when you initiate the Send OTP to Signatory Email API. For more information, refer to Send OTP to Signatory Email API

Sample Request

curl --location --request POST '{{onboarding_url}}/api/v3/merchants/{{merchant_uuid}}/kyc_documents/{{kyc_doc_uuid}}/esign_merged_document' \
--header 'Authorization: Bearer {{access_token}}' \
--data-urlencode 'otp=0025'

Where {{onboarding_url}} is substituted with the URL specified in the Test or Production environment as mentioned in the Environment section.

Sample Response

Success Scenario

Successful response

{
  "kyc_document": {
    "id": 276,
    "document_category_id": 13,
    "document_type_id": null,
    "account_id": null,
    "remarks": null,
    "status": "Counter Signed Received",
    "uuid": "11eb-de39-fdc897e2-ade0-a483e7015be5",
    "active": true,
    "created_at": "2021-07-06T09:10:21.000Z",
    "updated_at": "2021-07-06T09:23:49.000Z",
    "kyc_document_type": "Agreement",
    "document_format": "Soft Copy",
    "e_stamp_number": null,
    "temp_account_id": null,
    "error": null,
    "record_type": "Merchant",
    "record_id": 1,
    "processed_document": {
      "id": 524,
      "metadata": {
        "identified": true
      },
      "filename": "Service Agreemente_stamp.pdf",
      "byte_size": 463727,
      "path": "/rails/active_storage/blobs/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdW9CIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a85cda277088a85f7d0f53c9bbe502d24c784f63/Service%20Agreemente_stamp.pdf",
      "kyc_document_uuid": "11eb-de39-fdc897e2-ade0-a483e7015be5"
    },
    "document_category_name": "Service Agreement",
    "document_type_name": null,
    "uploaded_documents": [],
    "document_category": {
      "id": 13,
      "name": "Service Agreement",
      "name_on_frontend": "SERVICE_AGREEMENT"
    }
  }
}

Failure Scenarios

Merchant is not found with the given merchant_uuid

Merchant is not found with the given merchant_uuid

{
  "status": "NotFound"
}

OTP has expired

OTP has expired

{
  "error": "OTP Expired, Please send new OTP."
}

OTP is incorrect

OTP is incorrect

{
  "error": "Entered OTP is incorrect. Otp attempts remaining are 9."
}

KYC document not found with the given merged_document_uuid

KYC document not found with the given merged_document_uuid

{
  "status": "NotFound"
}

Unauthorized response

Unauthorized response

{
  "status": "Unauthorized"
}

EXAMPLE QUESTIONS