Skip to content

Commit 2812bbc

Browse files
committed
Added support for multi aa instead of just onemoney
1 parent f38a023 commit 2812bbc

File tree

7 files changed

+12
-12
lines changed

7 files changed

+12
-12
lines changed

content/data/account-aggregator/api-integration/account-availability-apis.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ Body:
5151
},
5252
{
5353
"aa": "setu-aa",
54-
"vua": "9999999999@onemoney",
54+
"vua": "9999999999@setu",
5555
"status": false
5656
}
5757
],

content/data/account-aggregator/api-integration/consent-flow.mdx

+3-3
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Call this API to create a consent request. The details of the request will be pr
3232
"unit" : "MONTH",
3333
"value": "4"
3434
},
35-
"vua": "999999999@onemoney",
35+
"vua": "999999999", // {{mobile}} or {{mobile}}@handle. Ex: 999999999@setu or 999999999@onemoney
3636
"dataRange": {
3737
"from": "2020-04-01T00:00:00Z",
3838
"to": "2023-01-01T00:00:00Z"
@@ -228,7 +228,7 @@ If the consent is approved, the status in the response will be `ACTIVE`. After t
228228
"status": "PENDING",
229229
"context": [],
230230
"detail": {
231-
"vua": "9999999999@onemoney",
231+
"vua": "9999999999@anumati",
232232
"consentStart": "2023-04-04T07:10:41.165Z",
233233
"consentExpiry": "2023-08-02T12:40:41.165Z"
234234
},
@@ -268,7 +268,7 @@ If the consent is approved, the status in the response will be `ACTIVE`. After t
268268
"unit": "MONTH"
269269
},
270270
"fetchType": "PERIODIC",
271-
"vua": "99999999999@onemoney",
271+
"vua": "99999999999@anumati",
272272
"dataLife": {
273273
"value": 1,
274274
"unit": "YEAR"

content/data/account-aggregator/consent-object.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Consent object contains the information about all the different types of data th
2828
| `fetchType` | Enum to specify either `ONETIME` or `PERIODIC` fetch of data. | Yes |
2929
| `consentTypes` | Specifies the type of data being requested for, from your user—<br/><li>`PROFILE`—Personal details such as mobile number, date of birth, PAN etc.</li><li>`SUMMARY`—Information like mutual fund summary for total amount invested, current value, number of MFs and more.</li><li>`TRANSACTIONS`—List of records against some financial data—e.g., a bank statement.</li> | Yes |
3030
| `fiTypes` | Specifies the type of financial information being requested for. Possible enums—`DEPOSIT`, `MUTUAL_FUNDS`, `INSURANCE_POLICIES`, `TERM_DEPOSIT`, `RECURRING_DEPOSIT`, `SIP`, `GOVT_SECURITIES`, `EQUITIES`, `BONDS`, `DEBENTURES`, `ETF`, and more. Click <a href="/data/account-aggregator/fi-data-types" target="_blank">here</a> to learn more about the data types. | Yes |
31-
| `vua` | Virtual user address (VUA) that identifies your customer when they login to the Account Aggregator. It should be sent in the format of **{customer_mobile_number}@onemoney-aa** | Yes |
31+
| `vua` | Virtual user address (VUA) that identifies your customer when they login to the Account Aggregator.<br/>It can be either mobile number or mobile number with handle (**{customer_mobile_number}@onemoney**)<br/><li>If mobile@handle is used, consent will be created for the specified AA</li><li>If mobile is used, a best perfroming AA is selected for consent creation</li> | Yes |
3232
| `purpose` | This is used to indicate the purpose of requesting for data. As per the AA spec, the following codes are supported—<br/><li>`101`—Wealth management service</li><li>`102`—Customer spending patterns, budget or other reportings</li><li>`103`—Aggregated statement</li><li>`104`—Explicit consent to monitor the accounts</li><li>`105`—Explicit one-time consent for accessing data from the accounts</li> | Yes |
3333
| `dataRange` | This is used to specify the `from` and `to` date-time range for querying financial information. It is mandatory only when the `consentTypes` array includes `TRANSACTIONS`. | Mandatory |
3434
| `dataLife` | This is the time period for which you are allowed to process the data. Choose between `MONTH`, `YEAR`, `DAY`, `INF` as the `unit` and define a numeric `value` alongside. <br /> For more details on the difference between Data life and Data Storage, please see [Sahamati guidelines](https://sahamati.org.in/aa-community-guidelines-v1/storage-of-data/) (see SD001 in the table) | Yes |

content/data/account-aggregator/overview.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ visible_in_sidebar: true
77

88
## Account Aggregator
99

10-
Account aggregators(AAs) are <a href="https://www.rbi.org.in/Scripts/bs_viewcontent.aspx?Id=3142" target="_blank">regulated entities</a> that facilitate consented sharing of financial data by utilising the <a href="http://www.niti.gov.in/node/1299" target="_blank">DEPA</a> framework. They act as the bridge between data providers such as banks, and data consumers such as lenders—to enable the sharing of a user’s financial data based on their explicit consent. Setu currently provides AA-related services in close partnership with a <a href="https://www.onemoney.in/" target="_blank">fully-licensed AA.</a>
10+
Account aggregators(AAs) are <a href="https://www.rbi.org.in/Scripts/bs_viewcontent.aspx?Id=3142" target="_blank">regulated entities</a> that facilitate consented sharing of financial data by utilising the <a href="http://www.niti.gov.in/node/1299" target="_blank">DEPA</a> framework. They act as the bridge between data providers such as banks, and data consumers such as lenders—to enable the sharing of a user’s financial data based on their explicit consent. Setu currently provides AA-related services in close partnership with <a href="https://sahamati.org.in/account-aggregators-in-india/" target="_blank">fully-licensed AA(s).</a>
1111

1212
<Callout type="highlight">
1313
Data providers are called Financial Information Providers (FIPs) and data

content/data/account-aggregator/v1/api-integration/consent-flow.mdx

+3-3
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ Read up more about the the `Detail` object <a href="/data/account-aggregator/con
3434
"consentStart": "2022-01-06T06:23:51.832Z",
3535
"consentExpiry": "2022-04-23T05:44:53.822Z",
3636
"Customer": {
37-
"id": "9999999999@onemoney" // {mobile_number@onemoney}
37+
"id": "9999999999@setu" // {mobile_number@setu}
3838
},
3939
"FIDataRange": {
4040
"from": "2021-04-01T00:00:00Z",
@@ -107,7 +107,7 @@ Read up more about the the `Detail` object <a href="/data/account-aggregator/con
107107
"consentStart": "2022-01-06T06:23:51.832Z",
108108
"consentExpiry": "2022-04-23T05:44:53.822Z",
109109
"Customer": {
110-
"id": "9999999999@onemoney" // {mobile_number@onemoney}
110+
"id": "9999999999@setu" // {mobile_number@setu}
111111
},
112112
"FIDataRange": {
113113
"from": "2021-04-01T00:00:00Z",
@@ -289,7 +289,7 @@ If the consent is approved, the Status in the response will be `ACTIVE`. After t
289289
"consentStart": "2022-01-06T06:23:51.832Z",
290290
"consentExpiry": "2022-04-23T05:44:53.822Z",
291291
"Customer": {
292-
"id": "9999999999@onemoney" // {mobile_number@onemoney}
292+
"id": "9999999999@setu" // {mobile_number@setu}
293293
},
294294
"FIDataRange": {
295295
"from": "2021-04-01T00:00:00Z",

content/data/account-aggregator/v1/consent-object.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ This consent object carries information about all the different types of data th
2121
| `consentTypes` | An array to specify the type of data being requested for, from your user<br/><li>`PROFILE`—Personal details such as mobile number, date of birth, PAN etc.</li><li>`SUMMARY`—Information like mutual fund summary for total amount invested, current value, number of MFs and more.</li><li>`TRANSACTIONS`—List of records against some financial data—e.g., a bank statement, buy/sell orders in a equities account, etc.</li> | Yes |
2222
| `fiTypes` | An array specifying the type of financial information being requested for. Possible enums—`DEPOSIT`, `MUTUAL_FUNDS`, `INSURANCE_POLICIES`, `TERM_DEPOSIT`, `RECURRING_DEPOSIT`, `SIP`, `GOVT_SECURITIES`, `EQUITIES`, `BONDS`, `DEBENTURES`, `ETF`, and more. Click <a href="/data/account-aggregator/fi-data-types" target="_blank">here</a> to learn more about the data types. | Yes |
2323
| `DataConsumer.id` | This is the identifier for the entity that’s requesting for the data. <br/>On UAT, it is a static value – “setu-fiu-id” <br/> On production, it will be a unique “FIU ID” assigned to your organizaiton. | Yes |
24-
| `Customer.id` | What your customer would use to login to Setu’s AA. It should be sent in the format of **<customer_mobile_number>@onemoney** <br/> Use this to pass on the customer's phone number and auto-fill their number when they login. | Yes |
24+
| `Customer.id` | What your customer would use to login to Setu’s AA. It should be sent in the format of **<customer_mobile_number>@finvu** <br/> Use this to pass on the customer's phone number and auto-fill their number when they login. | Yes |
2525
| `Purpose` | This is used to indicate the purpose of requesting for data. As per the AA spec, the following codes are supported—<br/><li>`101`—Wealth management service</li><li>`102`—Customer spending patterns, budget or other reportings</li><li>`103`—Aggregated statement</li><li>`104`—Explicit consent to monitor the accounts</li><li>`105`—Explicit one-time consent for accessing data from the accounts</li> | Yes(single option) |
2626
| `FIDataRange` | This is used to specify the `from` and `to` date-time range for querying financial information. It is mandatory only when the `consentTypes` array includes `TRANSACTIONS`.<br/>The `from` and `to` date-time can be both - past dates & future dates. Future dates, typically correspond to `PERIODIC` fetches, while a `from` and `to` date-time in the past corresponds to ONETIME fetches. | Only when `consentTypes` array includes `TRANSACTIONS` |
2727
| `DataLife` | This is the time period for which you are allowed to process the data. Choose between `MONTH`, `YEAR`, `DAY`, `INF` as the `unit` and define a numeric `value` alongside. <br /> For more details on the difference between ‘DataLife’ & “Data Storage” please [click here](https://sahamati.org.in/aa-community-guidelines-v1/storage-of-data/) (check SD001 from the list of guidelines) | Yes |

content/data/account-aggregator/v1/overview.mdx

+2-2
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ visible_in_sidebar: true
77

88
## Account Aggregator
99

10-
Account aggregators(AAs) are <a href="https://www.rbi.org.in/Scripts/bs_viewcontent.aspx?Id=3142" target="_blank">regulated entities</a> that facilitate consented sharing of financial data by utilising the <a href="http://www.niti.gov.in/node/1299" target="_blank">DEPA</a> framework. They act as the bridge between data providers such as banks, and data consumers such as lenders—to enable the sharing of a user’s financial data based on their explicit consent. Setu currently provides AA-related services in close partnership with a <a href="https://www.onemoney.in/" target="_blank">fully-licensed AA.</a>
10+
Account aggregators(AAs) are <a href="https://www.rbi.org.in/Scripts/bs_viewcontent.aspx?Id=3142" target="_blank">regulated entities</a> that facilitate consented sharing of financial data by utilising the <a href="http://www.niti.gov.in/node/1299" target="_blank">DEPA</a> framework. They act as the bridge between data providers such as banks, and data consumers such as lenders—to enable the sharing of a user’s financial data based on their explicit consent. Setu currently provides AA-related services in close partnership with <a href="https://sahamati.org.in/account-aggregators-in-india/" target="_blank">fully-licensed AA(s).</a>
1111

1212
<Callout type="highlight">
1313
Data providers are called Financial Information Providers (FIPs) and data
@@ -38,7 +38,7 @@ Try out our sample app built using Setu AA sandbox <a href="https://github.com/S
3838

3939
#### What can you build?
4040

41-
Setu’s AA related services are powered by a <a href="https://www.onemoney.in/" target="_blank">licensed NBFC-AA partner.</a> The AA framework opens up a lot of opportunities for FIU apps to build financial user journeys with seamless user consented data sharing. This allows developers to build tech-first user applications and features powered by digital data sharing flows over conventional PDF documents upload. Some of the use cases worth exploring:
41+
Setu’s AA related services are powered by <a href="https://sahamati.org.in/account-aggregators-in-india/" target="_blank">licensed NBFC-AA partners.</a> The AA framework opens up a lot of opportunities for FIU apps to build financial user journeys with seamless user consented data sharing. This allows developers to build tech-first user applications and features powered by digital data sharing flows over conventional PDF documents upload. Some of the use cases worth exploring:
4242

4343
1. **Income Verification** - Get access to users’ bank statements with their consents. While Setu AA ensures that the data payload remains standardised and error free, simplify your user verification process and improve conversion rates!
4444
2. **Loan Monitoring** - Monitor your borrower’s financial health after loan disbursal by analysing cash flow across a user’s bank accounts. As a lender, get early signals from a user's bank statements and prevent potential loan defaults.

0 commit comments

Comments
 (0)