Get Details

Introduction

The Get Details API works by taking the unique transaction ID generated from the Create Link API and returns comprehensive bank account details linked to that transaction.

API details

Endpoint

POST https://api.signzy.app/api/v3/bankaccountverification/reversepennydrop/get-details

POST https://api-preproduction.signzy.app/api/v3/bankaccountverification/reversepennydrop/get-details

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
verificationId	String	ID to get details of the bank account. This is returned as "id" in the response of Create Link API	Mandatory

{
    "verificationId": "6570585c3122f4ddc7e8e73b"
}

Code samples

curl --location 'https://api-preproduction.signzy.app/api/v3/bankaccountverification/reversepennydrop/get-details' \
--header 'Authorization: <Your access token>' \
--header 'Content-Type: application/json' \
--data '{
    "verificationId": "6570585c3122f4ddc7e8e73b"
}'

Response body parameters

Parameter	Data Type	Description
requestId	String	Unique ID for the request.
bankAccountNumber	String	Bank account number involved in the transaction.
ifsc	String	IFSC code of the bank.
upiHandle	String	UPI handle associated with the transaction.
nameAtBank	String	Name of the account holder at the bank.
utr	String	Unique Transaction Reference number.
status	String	Status of the transaction. The possible values are: FAILURE or SUCCESS or EXPIRED
addedOn	String	Timestamp when the transaction was added.
processedOn	String	Timestamp when the transaction was processed.
pennyCollectedOn	String	Timestamp of penny collection in the transaction.
reversalStatus	String	Status of any reversal in the transaction.

// When verificationId is not in requestBody
{
    "error": {
        "name": "error",
        "message": "\"verificationId\" is required",
        "reason": "VALIDATION_ERROR",
        "type": "Bad Request",
        "statusCode": 400
    }
}

// When verificationId is passed as empty string
{
    "error": {
        "name": "error",
        "message": "\"verificationId\" is not allowed to be empty",
        "reason": "VALIDATION_ERROR",
        "type": "Bad Request",
        "statusCode": 400
    }
}

// Payment links expired after 5 minutes
{
   "error": {
       "name": "error",
       "message": "Payment links expired, please raise a new request.",
       "reason": "BAD_REQUEST",
       "type": "Bad Request",
       "statusCode": 400
   }
}
 
// Response After 30 mins of successful transaction by user for reverse pennydrop(transaction status will be valid for 30 mins form the time of initiation):
"error": {
    "name": "error",
    "message": "The verification request is expired, Please initiate a new request.",
    "reason": "VERIFICATION_EXPIRED",
    "type": "Bad Request",
    "statusCode": 400
  }
}

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!