Call Back-HMAC addition

Introduction

Call Back- HMAC addition API is designed to provide robust and secure communication for your digilocker Journey. This API uses HMAC (Hash-based Message Authentication Code) to ensure that all interactions are secure and verifiable. The Signzy support team will use this API to create an HMAC secret key for the clients.

API details

Endpoint

POST https://api.signzy.app/api/v3/digilocker/setHmacSecret

POST https://api-preproduction.signzy.app/api/v3/digilocker/setHmacSecret

Request headers

Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Request body parameters

Parameter	Data Type	Description	Required
customerId	String	Customer ID or Patron ID of the Client.	Mandatory
hmacSecret	String	HMAC secret key. It should contain less than 25 alpha-numeric characters. This will be set by the Signzy support team and shared with the client for their respective patron ID.	Mandatory

{
    "customerId" : "<customerID>",
    "hmacSecret": "<clientSecret>"
}

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/digilocker/setHmacSecret' \
--header 'Authorization: <Your access token>' \
--header 'Content-Type: application/json' \
--data '{
    "customerId" : "<customerID>", 
    "hmacSecret": "<clientSecret>" 
}'

Response body parameters

Parameter	Data Type	Description
result	Object	Contains the result of the task.
result.success	Boolean	Indicates if the HMAC is set to the Patron ID. true/false

{
    "result": {
        "success": true
    }
}

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!