Estamp Migration from v1 to v2

Change domain url for all APIs

https://live.zoop.one to be changed to https://live.zoop.plus .

https://test.zoop.one to be changed to https://test.zoop.plus

Replace v1 Branches API with v2 Branches API

Estamp Branches v1 Api->https://documenter.getpostman.com/view/36322101/2sB2cVdMSw#0cb63d7f-6d33-4c3b-b412-ff7ed13290c9

Estamp Branches v2 Api->https://documenter.getpostman.com/view/29380795/2sB2cYcg1s#6df87abd-3b84-477d-b6f4-895d77006548

v1 in api url should be changed to v2.

response body has been altered.Variable like branch_id, branch_name and branch_code has been replaced by id, name and code.All branch ids and branch codes has been updated in v2

Replace v1 Articles API with v2 Articles API

Estamp Articles v1 Api->https://documenter.getpostman.com/view/36322101/2sB2cVdMSw#e4a01f31-2c4b-4774-a671-528e073cff55

Estamp Articles v2 Api->https://documenter.getpostman.com/view/29380795/2sB2cYcg1s#8fcac9db-5419-4b85-b4a4-90e62e734aa5

v1 in api url should be changed to v2. query param branch should be changed to stateCode[0]

response body has been altered.Variable like id, article_code and article_name has been replaced by id, number and description.

Replace v1 Estamp Intialisation API with v2 Estamp Intialisation API

Estamp v1 Intialisation API- https://documenter.getpostman.com/view/36322101/2sB2cVdMSw#fb5efe6d-b0a6-4888-b938-7bb7a4cda979

Estamp v2 Attachment API- https://documenter.getpostman.com/view/29380795/2sB2cYcg1s#10072386-e3dc-49c5-9694-20d63cc004cf

Replace v1/init in api url with v2/contract/init

recepientEmail has been changed to recipientEmail in v2 api.responseUrl has been changed to callbackUrl. stampDutyPaidBy in v2 api can have only 2 values-FIRST_PARTY,SECOND_PARTY

in v2,there is no procure field.if file field is passed,its attachment journey otherwise procurement journey.

V1 Field Name	v2 Field Name

V1 Field Name	v2 Field Name
stampType	stampType
stampDutyAmount	stampDutyAmount
articleId	articleId
considerationPrice	considerationPrice
purpose	purpose
recepientEmail	recipientEmail
firstPartyName	firstPartyName
secondPartyName	secondPartyName
stampDutyPaidBy(Possible Values- first_party_name,second_party_name)	stampDutyPaidBy(Possible Values- FIRST_PARTY,SECOND_PARTY)
responseUrl	callbackUrl
file	file

Instead of estamp id(request id) in response ,you will get order id in response in v2 api.you will need to use this order id to get estamp id.estamp id can be obtained only after order is fulfilled.

Replace Get Estamp Details V1 Api with Get Order Details V2 Api

Estamp v1 API-https://documenter.getpostman.com/view/36322101/2sB2cVdMSw#ee238c98-f4b1-4074-ab9e-9e1069c1d4a7

Estamp v2 API-https://documenter.getpostman.com/view/29380795/2sB2cYcg1s#1a42facd-2334-4647-8748-612cdb7303a5

if status is FULFILLED(estamp has been procured) in v2 order api, eStampId and stampCertificateUrl Url will be present in api response which can be used to retrieve estamp id and estamp document .To retrieve certificate details for the estamp.you need to call Fetch Estamp Details API with obtained eStampId https://documenter.getpostman.com/view/29380795/2sB2cYcg1s#a2fd3afb-5221-4127-92e5-bd196bb8a48c .In case of attachment journey,estampWithAttachment field gives you url of the document merged with estamp.

Estamp and Esign API

https://documenter.getpostman.com/view/29380795/2sB2cYcg1s#fa472cdb-fbcb-4b2f-8683-1f59bdea3364

its same as before.you just need to pass an additional field estamp_version with value as ”v2” along with estamp_required and estamp_id fields.

Sample Webhook Responses in v2

request id in webhook corresponds to order id .estampGroupId in webhook corresponds to estamp id.

for procurement journey

{
  "request_id": "STEST000023",//order id
  "success": true,
  "response_code": "100",
  "response_message": "Transaction Successful",
  "metadata": {
    "billable": "Y"
  },
  "result": {
    "estamp": {
      "certificates": [
        {
          "id": "cmbqh4nrl00900t9saqjc3l0n",
          "issuedAt": "2025-06-10T12:05:07.502Z",
          "expiresAt": "2025-12-10T12:05:07.502Z",
          "uniDocRefNo": "GJ56899472279398W",
          "certificateNo": "6892Y304",
          "accountReferenceId": "NEWIMPACC (SV)/gj8000502/AHMEDABAD/ GJ-CC",
          "file": "6627a55554472000280ca70c/estamps/cmbqh4nrl008x0t9seqdybxvd/cmbqh4nrl00900t9saqjc3l0n.pdf",
          "stampDutyAmount": "100",
          "numOfPages": 1,
          "parties": {
            "firstParty": "Jenisha",
            "secondParty": "Ravi",
            "stampDutyPaidBy": "FIRST_PARTY",
            "firstPartyPan": null,
            "secondPartyPan": null,
            "firstPartyPhoneNumber": null,
            "secondPartyPhoneNumber": null
          },
          "series": {
            "stateCode": "GJ",
            "stampDutyAmount": "100",
            "stampType": "ESTAMP",
            "considerationPrice": "500",
            "purpose": "loan aggrement",
            "taxCharges": 0,
            "article": {
              "number": "Article 3"
            }
          }
        }
      ],
      "status": "ACTIVE",
      "estampGroupId": "cmbqh4nrl008x0t9seqdybxvd",//estampId
      "consumedRefId": null,
      "consumedAt": null,
      "orderId": "STEST000023",
      "file": "https://storage.googleapis.com/zsp-kaio-prod/6627a55554472000280ca70c/estamps/cmbqh4nrl008x0t9seqdybxvd/merged_estamps.pdf?GoogleAccessId=zsp-kaio-service-prod%40zoop-production.iam.gserviceaccount.com&Expires=1749558549&Signature=nm%2B5h8hVdbc%2FA%2BOU6xZibBjkOxdYRA4nfrWzxaXh2Bumx%2FCBx%2BylW%2FpXoUSw2l3RX%2BRs2SlWXgEYHzS324KXQHano3YO7u%2FPAda6Ala93zb6C4wDxGlCoSC52eJL14Ve4woIGJFrVNopD2KU9zS4R72UUza7CtfoCSLFw93I5yEart6WgK%2BcAGta00GGYsNswfzRKeLqCS0w297SoC68b6BGVvNpUedTaVqkkr4up8QZpIaGcU4R3xFglufgoXsOSrPAzUxZOTxk0N%2Fj2Ft5sST0zO3OuF6hwaP4ZdKqjuyUCJrR5qrQ0bAvepAEHeQWIU07%2Fb8gaiXO8SHR3jX%2BtA%3D%3D"
    }
  }
}

for attachment journey

{
  "request_id": "SZOOP000117",//order id
  "success": true,
  "response_code": "100",
  "response_message": "Transaction Successful",
  "metadata": {
    "billable": "Y"
  },
  "result": {
    "estamp": {
      "certificates": [
        {
          "id": "cmbhtl2yg000o0t9dcj394gdu",
          "issuedAt": "2025-06-04T10:43:53.438Z",
          "expiresAt": "2025-12-04T10:43:53.438Z",
          "uniDocRefNo": "GJ56899472279398W",
          "certificateNo": "6892Y852",
          "accountReferenceId": "NEWIMPACC (SV)/gj8000502/AHMEDABAD/ GJ-CC",
          "file": "66757c9e749f46002866dfaf/estamps/cmbhtl2yg000l0t9d5eyz6mj0/cmbhtl2yg000o0t9dcj394gdu.pdf",
          "stampDutyAmount": "500",
          "numOfPages": 1,
          "parties": {
            "firstParty": "Jenisha",
            "secondParty": "Ravi",
            "stampDutyPaidBy": "FIRST_PARTY",
            "firstPartyPan": null,
            "secondPartyPan": null,
            "firstPartyPhoneNumber": null,
            "secondPartyPhoneNumber": null
          },
          "series": {
            "stateCode": "GJ",
            "stampDutyAmount": "500",
            "stampType": "ESTAMP",
            "considerationPrice": "500",
            "purpose": "loan aggrement",
            "taxCharges": 0,
            "article": {
              "number": "Article 3"
            }
          }
        }
      ],
      "status": "ACTIVE",
      "estampGroupId": "cmbhtl2yg000l0t9d5eyz6mj0",//estampId
      "consumedRefId": null,
      "consumedAt": null,
      "orderId": "SZOOP000117",
      "file": "https://storage.googleapis.com/zsp-kaio-dev/66757c9e749f46002866dfaf/estamps/cmbhtl2yg000l0t9d5eyz6mj0/merged_estamps.pdf?GoogleAccessId=zsp-kaio-service-dev%40zoop-one-development.iam.gserviceaccount.com&Expires=1749035277&Signature=QlOXjv2CZ%2BdFLfgz18jNJB4CKk0phRH2GwaRJw0TFROXwbGbVbo1x7No6GvuEIaafOz0y6n1eZ7e1Zy9abb%2FjwbCIZ4aOehXi0H%2BW9ysSLSh38vqzgriTZGZrwInnQTnCAGOKX3kQbaZTevgIErfM4HtaHvLuAYX9e4eud0hiy%2FX17Jdmpq9x%2FOi8QPeHQtDLn6c5G%2BEUm4c2Z1TdEtHx0Ursd07lV2nZ5O06Tj0lj%2FROZIle9yy0aPAfsib6CaYDAeI7ELhCaxwqNm%2BBHbDTHIQ3wcVQAMiI60GOXWwg13HMabaKZQrIuXUe0Ia7VR71k6Fhd85ZYGY9hJ%2BCvh7nw%3D%3D",
      "estampWithAttachment": "https://storage.googleapis.com/zsp-kaio-dev/66757c9e749f46002866dfaf/orders/SZOOP000117/attachment/cmbhtl2yg000l0t9d5eyz6mj0.pdf?GoogleAccessId=zsp-kaio-service-dev%40zoop-one-development.iam.gserviceaccount.com&Expires=1749035277&Signature=Z0eKGqFehsN9zqekd3oZdblLI4D5d4u6ainR0ibTh6GYxo%2FiTrWEE9eWo2jCZL0nEFu7ML8XiHIEb27UQAWXVtRkQKWvdVBI2T4yIQTrvkVvkZ3qX6idG0aIaDVEb%2BMsKXdjpy96IpgSdrjRPr97X7HMG6jVwiaE1sAEyOPALiwLSqBpqJ5qSQstqtA3RU9ZJUf5Q2XcsCjxqvB4DGvLDjzIhmHX4ZNhGYwzYLZq2SaABDHr%2FSbxIvo3bUyrpXtJsOY9yvQUAqtIjmApiihpa1ualCpAdzUOwIGOMmbq3pibA6osFEwvL8uA%2BWFo5ru1yr4%2Frxb7R6f1vMu0bbi5PQ%3D%3D"
    }
  }
}