Bank Account - Pennydrop
Data extraction of bank account - penny drop refers to the process of collecting and retrieving information from a bank account.
ind_bank_account
POST https://secctrl.tutelar.io/api/v1/kyc/banking/ind_bank_account
Post parameters description is given below,
Post Parameter
Type
Is Mandatory
Description
account_number
String
Yes
Account Number
ifsc_code
String
Yes
IFSC Code
Sample Post Parameters
{
"account_number": "6147380000",
"ifsc_code": "IDIB088T000"
}{
"success": true,
"code": 200,
"message": "The request has been successfully completed.",
"reference_id": "10cc9473-ce11-425e-ac89-1f51ce6e78de",
"status": "completed",
"result": {
"message": "Transaction Successful",
"name_at_bank": "R GOWTHAM",
"account_number": "6147380000",
"ifsc_code": "IDIB000T000",
"account_exists": "YES",
"amount_deposited": "1"
},
"requested_at": "2024-04-22T05:28:49.245Z",
"completed_at": "2024-04-22T05:28:52.000Z"
}{
"success": true,
"code": 200,
"message": "The request is being processed. Please wait for completion.",
"reference_id": "10cc9473-ce11-425e-ac89-1f51ce6e78de",
"status": "in_progress",
"requested_at": "2024-04-22T05:28:49.245Z"
}{
"success": false,
"code": 400,
"message": "Invalid input. Please check your request and try again.",
"error": {
"message": "Invalid ifsc code",
"field": "ifsc_code",
"code": "BAD_REQUEST"
}
}{
"success": true,
"code": 200,
"message": "The request could not be completed due to an error.",
"reference_id": "3c94fbf2-1dd0-4d8b-ac9b-d0cccfb1d02a",
"status": "failed",
"error": {
"message": "Invalid details were provided. Please submit valid details.",
"code": "ERROR"
},
"requested_at": "2024-04-22T05:34:58.477Z",
"completed_at": "2024-04-22T05:35:06.000Z"
}Check Document Status
Get document details
This Get details API using to fetch the latest updated response when the above API gave the status as in-progress by using the reference_id
GET https://secctrl.tutelar.io/api/v1/kyc/document/details
Query parameters description is given below,
Query Parameter
Type
Is Mandatory
Description
reference_id
String
Yes
Document reference id
{
"success": true,
"code": 200,
"message": "The request has been successfully completed.",
"reference_id": "10cc9473-ce11-425e-ac89-1f51ce6e78de",
"status": "completed",
"result": {
"message": "Transaction Successful",
"name_at_bank": "R GOWTHAM",
"account_number": "6147380000",
"ifsc_code": "IDIB088T000",
"account_exists": "YES",
"amount_deposited": "1"
},
"requested_at": "2024-04-22T05:28:49.245Z",
"completed_at": "2024-04-22T05:28:52.000Z"
}{
"success": true,
"code": 200,
"message": "The request is being processed. Please wait for completion.",
"reference_id": "10cc9473-ce11-425e-ac89-1f51ce6e78de",
"status": "in_progress",
"requested_at": "2024-04-22T05:28:49.245Z"
}{
"success": true,
"code": 200,
"message": "The request could not be completed due to an error.",
"reference_id": "3c94fbf2-1dd0-4d8b-ac9b-d0cccfb1d02a",
"status": "failed",
"error": {
"message": "Invalid details were provided. Please submit valid details.",
"code": "ERROR"
},
"requested_at": "2024-04-22T05:34:58.477Z",
"completed_at": "2024-04-22T05:35:06.000Z"
}Last updated