API Test Keys

Fetch Account Validation Transactions With ID

GET

/v1/fund_accounts/validations/:id

Click to copy

Use this endpoint to retrieve a particular Fund Account Validation transaction with its id.

Is this page helpful?

Curl

1curl -u <YOUR_KEY>:<YOUR_SECRET> \
2    -X GET https://api.razorpay.com/v1/fund_accounts/validations/fav_00000000000001

Success

1{
2    "id": "fav_00000000000001",
3    "entity": "fund_account.validation",
4    "status": "completed",
5    "validation_results": {
6        "account_status": "valid",
7        "registered_name": "Gaurav Kumar",
8        "details": "The beneficiary account is valid." ,
9        "name_match_score": 100
10                        },
11    "status_details": {
12        "description": "Validation request is completed",
13        "source": "beneficiary_bank",
14        "reason": "validation_completed"
15                },
16    "reference_id": "112233",
17    "notes": {
18        "random_key_1": "Make it so.",
19        "random_key_2": "Tea. Earl Grey. Hot."
20         },
21    "fund_account": {
22        "id": "fa_00000000000001",
23        "entity": "fund_account",
24        "account_type": "bank_account",
25        "bank_account": {
26            "name": "Gaurav Kumar",
27            "bank_name": "HDFC",
28            "ifsc": "HDFC0000053",
29            "account_number": "765432123456789"
30                },
31        "active": true,
32        "created_at": 1567064019,
33        "contact": {
34            "id": "cont_00000000000001",
35            "entity": "contact",
36            "name":"Gaurav Kumar",
37            "email":"gaurav.kumar@example.com",
38            "contact":"9123456789",
39            "type":"employee",
40            "reference_id":"Acme Contact ID 12345",
41            "active": true,
42            "created_at": 1567064019,
43            "notes":{
44            "notes_key_1":"Tea, Earl Grey, Hot",
45            "notes_key_2":"Tea, Earl Grey... decaf."
46                }
47        }
48    }
49}

Path Parameters

id

string

This is the unique identifier linked to the account validation transaction. For example, fav_00000000000001.

Response Parameters

id

string

The unique identifier linked to the fund account. For example, fa_00000000000001.

entity

string

Here it will be fund_account.validation.

status

string

The status of the account validation transaction. Possible values:

created
completed
failed

validation_results

object

Result of the validation.

Show child parameters (4)

status_details

object

This parameter returns the current status of the customer's bank account.

Show child parameters (3)

fund_account

object

Fund account details to which the payout was made.

Show child parameters (3)

contact

object

Contact details to which the payout was made.

Show child parameters (6)

reference_id

string

A user-generated reference given to the payout. Maximum length is 40 characters. For example, 112233. You can use this field to store your own transaction ID, if any.

notes

object

User-entered notes for internal reference. This is a key-value pair. You can enter a maximum of 15 key-value pairs. For example, "note_key": "Beam me up Scotty”.

active

boolean

Possible values of Fund Account status:

true: active
false: inactive

created_at

integer

Timestamp, in Unix, when the fund account was created. For example, 1543650891.

Fetch Account Validation Transactions With ID

GET

/v1/fund_accounts/validations/:id

Click to copy

Use this endpoint to retrieve a particular Fund Account Validation transaction with its id.

Is this page helpful?

Path Parameters

id

string

This is the unique identifier linked to the account validation transaction. For example, fav_00000000000001.

Response Parameters

id

string

The unique identifier linked to the fund account. For example, fa_00000000000001.

entity

string

Here it will be fund_account.validation.

status

string

The status of the account validation transaction. Possible values:

created
completed
failed

validation_results

object

Result of the validation.

Show child parameters (4)

status_details

object

This parameter returns the current status of the customer's bank account.

Show child parameters (3)

fund_account

object

Fund account details to which the payout was made.

Show child parameters (3)

contact

object

Contact details to which the payout was made.

Show child parameters (6)

reference_id

string

A user-generated reference given to the payout. Maximum length is 40 characters. For example, 112233. You can use this field to store your own transaction ID, if any.

notes

object

User-entered notes for internal reference. This is a key-value pair. You can enter a maximum of 15 key-value pairs. For example, "note_key": "Beam me up Scotty”.

active

boolean

Possible values of Fund Account status:

true: active
false: inactive

created_at

integer

Timestamp, in Unix, when the fund account was created. For example, 1543650891.

Curl

1curl -u <YOUR_KEY>:<YOUR_SECRET> \
2    -X GET https://api.razorpay.com/v1/fund_accounts/validations/fav_00000000000001

Success

1{
2    "id": "fav_00000000000001",
3    "entity": "fund_account.validation",
4    "status": "completed",
5    "validation_results": {
6        "account_status": "valid",
7        "registered_name": "Gaurav Kumar",
8        "details": "The beneficiary account is valid." ,
9        "name_match_score": 100
10                        },
11    "status_details": {
12        "description": "Validation request is completed",
13        "source": "beneficiary_bank",
14        "reason": "validation_completed"
15                },
16    "reference_id": "112233",
17    "notes": {
18        "random_key_1": "Make it so.",
19        "random_key_2": "Tea. Earl Grey. Hot."
20         },
21    "fund_account": {
22        "id": "fa_00000000000001",
23        "entity": "fund_account",
24        "account_type": "bank_account",
25        "bank_account": {
26            "name": "Gaurav Kumar",
27            "bank_name": "HDFC",
28            "ifsc": "HDFC0000053",
29            "account_number": "765432123456789"
30                },
31        "active": true,
32        "created_at": 1567064019,
33        "contact": {
34            "id": "cont_00000000000001",
35            "entity": "contact",
36            "name":"Gaurav Kumar",
37            "email":"gaurav.kumar@example.com",
38            "contact":"9123456789",
39            "type":"employee",
40            "reference_id":"Acme Contact ID 12345",
41            "active": true,
42            "created_at": 1567064019,
43            "notes":{
44            "notes_key_1":"Tea, Earl Grey, Hot",
45            "notes_key_2":"Tea, Earl Grey... decaf."
46                }
47        }
48    }
49}