Get Wallet Logs API (eStamping)

Introduction

Embark on a seamless journey of financial transparency with the revolutionary Signzy system, offering clients the ability to effortlessly access their transaction logs. Within a specified time range, clients can delve into a wealth of transaction details, empowering them with unparalleled visibility and control over their financial activities. By utilizing the "Parameter type," a powerful identifier, clients can effortlessly retrieve their eStamp or eChallan logs, unveiling a comprehensive record of their transactions. Bid farewell to uncertainty and embrace a world where financial insights are readily available at your command, courtesy of Signzy's intuitive and secure platform.

Client can check their transation logs in signzy system between a certain range of time. Parameter type is used to identify the eStamp or eChallan logs to be fetched.

Authentication

API authentication is a crucial security process that ensures authorized access to an application programming interface (API). It involves validating the identity of users or systems seeking to interact with the API. Please use the access token shared with you by your assigned Signzy's CSM. Please set the value of the key Authorization in the headers to the access token, while making an API call. In this way, Signzy's system will be able to authenticate you and you will be able to make a successful API call.

API Details

The details of the API can be found here.

Sample cURL (For One Touch Sign Product)

curl --location 'https://api-preproduction.signzy.app/api/v3/contract/eStamp/walletlogs' \
--header 'Authorization: **********************' \
--header 'Content-Type: application/json' \
--data '{
    "startDate": "10/08/2023",
    "endDate": "10/08/2023",
    "type": "eChallan"
}'

Sample cURL (For Contracting SDK Product)

Preproduction

Production

curl --location --request POST 'https://contracting-preproduction.signzy.tech/api/customers/<<<customerId>>>/estamp/walletLogs' \
--header 'Authorization: <Auth Key>' \
--header 'Content-Type: application/json' \
--data-raw '{
         "type": "..eStamp/eChallan..",
         "startDate": "...DD/MM/YYYY...",
         "endDate": "...DD/MM/YYYY...",
         "amount":"...amount...",
         "stateCode": "...stateCode...",
         "articleCode": "...articleCode...",
         "eChallanNo":"...eChallanNo..."
    }

curl --location --request POST 'https://contracting.signzy.tech/api/customers/<<<customerId>>>/estamp/walletLogs' \
--header 'Authorization: <Auth Key>' \
--header 'Content-Type: application/json' \
--data-raw '{
       "type": "..eStamp/eChallan..",
         "startDate": "...DD/MM/YYYY...",
         "endDate": "...DD/MM/YYYY...",
         "amount":"...amount...",
         "stateCode": "...stateCode...",
         "articleCode": "...articleCode...",
         "eChallanNo":"...eChallanNo..."
    }'

Input Parameters

PARAMETERS	DESCRIPTION	TYPE	MANDATORY/OPTIONAL
type	eStamp or eChallan By default eStamp will be used	String	Mandatory
startDate	Start date	String	Mandatory
endDate	End date	String	Mandatory

The duration at maximum can be 31 days.

Sample Response

{
    "result": {
        "logFile": "...logFile..."
    }
}

Output Parameters

PARAMETERS	TYPE	DESCRIPTION
logFile	String	CSV file

The following terms are used in CSV reports.

TimeStamp - Date and time of transaction
ContractId - contract Id with which it was used
Amount - Amount of the transaction
eChallanNumber - eChallan Number from which this amount was consumed
refrence - Sub challan number used for the transaction
First Party Name - Name of First Party
eChallan Date - Date of eChallan when it was purchased
State Code - State code for the eChallan
ArticleCode - Article code for the eChallan
Status - Status of the transaction(REVERTED,CONSUMED, INPROGRESS)
denomination- value of stamp in case of stamp.

Sample Error

{
    "name": "error",
    "message": "",
    "reason": "VALIDATION_ERROR",
    "type": "Bad Request",
    "statusCode": 400
}

Error Parameter

Parameter	Type	Description
name	String	In case of errors, it will have the value "error". It represents an error.
message	String	Message for the error
reason	String	Reasons for the error
type	String	Type of error
statusCode	String	Status code of the error

Error Codes

Error Code	Error Message	Explanation
400	Bad Request	Input parameter has a missing required parameter or invalid inputs
401	Authorization Failed	Authorization token is invalid
404	Not found	Not found
500	Internal Server Error	Internal error at Signzy, Please reach out to [email protected]