Secure ID APIs
V2
- Aadhaar
- Advanced Employment
- BAV V2
- CIN
- Digilocker
- PAN
- Driving License
- E-sign
- Face Match
- GSTIN
- IP
- Face Liveness
- Name Match
- PAN to GSTIN
- Passport
- Reverse Penny Drop
- Geocoding
- Reverse Geocoding
- Vehicle RC
- Voter ID
- Account Aggregator
- Mobile 360 OTP Flow
- 1-Click Onboarding
- BharatOCR
- IFSC
- KYC Links
- Video KYC
V1
- Bank Account Verification
Account Aggregator
Request Consent
Use this API to request consent from the individual to fetch the financial information.
POST
/
aa
/
consent
Copy
curl --request POST \
--url https://sandbox.cashfree.com/verification/aa/consent \
--header 'Content-Type: application/json' \
--header 'x-client-id: <api-key>' \
--header 'x-client-secret: <api-key>' \
--data '{
"consent_verification_id": "abc12345",
"customer_identifiers": [
{
"type": "MOBILE",
"value": "9876543210"
}
],
"consent_start": "2024-01-01T00:00:00Z",
"consent_expiry": "2024-12-31T23:59:59Z",
"fi_from": "2024-01-01T00:00:00Z",
"fi_to": "2024-12-31T23:59:59Z",
"redirect_url": "https://example.com/redirect",
"consent_mode": "STORE",
"consent_type": [
"PROFILE",
"SUMMARY",
"TRANSACTION"
],
"fi_types": [
"DEPOSIT"
],
"data_life_expiry": "2024-01-07",
"filter": [
{
"type": "TRANSACTION_AMOUNT",
"operator": "LESS_THAN",
"value": "20000"
}
],
"fetch_type": "ONETIME"
}'
Copy
{
"consent_verification_id": "abc12345",
"consent_ref_id": 67890,
"consent_redirect_url": "https://example.com/redirect",
"status": "PENDING",
"customer_identifiers": [
{
"type": "MOBILE",
"value": "9876543210"
}
],
"consent_start": "2024-01-01T00:00:00Z",
"consent_expiry": "2024-12-31T23:59:59Z",
"fi_from": "2024-01-01T00:00:00Z",
"fi_to": "2024-12-31T23:59:59Z",
"redirect_url": "https://example.com/redirect",
"consent_mode": "STORE",
"consent_type": [
"PROFILE",
"SUMMARY",
"TRANSACTION"
],
"fi_types": [
"DEPOSIT"
],
"data_life_expiry": "2024-01-07",
"filter": [
{
"type": "TRANSACTION_AMOUNT",
"operator": "LESS_THAN",
"value": "20000"
}
]
}
Authorizations
Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.
The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.
Body
application/json
Find the request parameters to request consent for AA.
The body is of type object
.
Response
200
application/json
Consent created successfully
The response is of type object
.
Was this page helpful?
Copy
curl --request POST \
--url https://sandbox.cashfree.com/verification/aa/consent \
--header 'Content-Type: application/json' \
--header 'x-client-id: <api-key>' \
--header 'x-client-secret: <api-key>' \
--data '{
"consent_verification_id": "abc12345",
"customer_identifiers": [
{
"type": "MOBILE",
"value": "9876543210"
}
],
"consent_start": "2024-01-01T00:00:00Z",
"consent_expiry": "2024-12-31T23:59:59Z",
"fi_from": "2024-01-01T00:00:00Z",
"fi_to": "2024-12-31T23:59:59Z",
"redirect_url": "https://example.com/redirect",
"consent_mode": "STORE",
"consent_type": [
"PROFILE",
"SUMMARY",
"TRANSACTION"
],
"fi_types": [
"DEPOSIT"
],
"data_life_expiry": "2024-01-07",
"filter": [
{
"type": "TRANSACTION_AMOUNT",
"operator": "LESS_THAN",
"value": "20000"
}
],
"fetch_type": "ONETIME"
}'
Copy
{
"consent_verification_id": "abc12345",
"consent_ref_id": 67890,
"consent_redirect_url": "https://example.com/redirect",
"status": "PENDING",
"customer_identifiers": [
{
"type": "MOBILE",
"value": "9876543210"
}
],
"consent_start": "2024-01-01T00:00:00Z",
"consent_expiry": "2024-12-31T23:59:59Z",
"fi_from": "2024-01-01T00:00:00Z",
"fi_to": "2024-12-31T23:59:59Z",
"redirect_url": "https://example.com/redirect",
"consent_mode": "STORE",
"consent_type": [
"PROFILE",
"SUMMARY",
"TRANSACTION"
],
"fi_types": [
"DEPOSIT"
],
"data_life_expiry": "2024-01-07",
"filter": [
{
"type": "TRANSACTION_AMOUNT",
"operator": "LESS_THAN",
"value": "20000"
}
]
}
Assistant
Responses are generated using AI and may contain mistakes.