Skip to content

Commit

Permalink
Added support for multi aa instead of just onemoney
Browse files Browse the repository at this point in the history
  • Loading branch information
AnubhavAtSetu committed Dec 2, 2024
1 parent f38a023 commit ebe94fe
Show file tree
Hide file tree
Showing 7 changed files with 12 additions and 12 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Body:
},
{
"aa": "setu-aa",
"vua": "9999999999@onemoney",
"vua": "9999999999@setu",
"status": false
}
],
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ Call this API to create a consent request. The details of the request will be pr
"unit" : "MONTH",
"value": "4"
},
"vua": "999999999@onemoney",
"vua": "999999999", // {{mobile}} or {{mobile}}@handle. Ex: 999999999@setu or 999999999@onemoney
"dataRange": {
"from": "2020-04-01T00:00:00Z",
"to": "2023-01-01T00:00:00Z"
Expand Down Expand Up @@ -228,7 +228,7 @@ If the consent is approved, the status in the response will be `ACTIVE`. After t
"status": "PENDING",
"context": [],
"detail": {
"vua": "9999999999@onemoney",
"vua": "9999999999@anumati",
"consentStart": "2023-04-04T07:10:41.165Z",
"consentExpiry": "2023-08-02T12:40:41.165Z"
},
Expand Down Expand Up @@ -268,7 +268,7 @@ If the consent is approved, the status in the response will be `ACTIVE`. After t
"unit": "MONTH"
},
"fetchType": "PERIODIC",
"vua": "99999999999@onemoney",
"vua": "99999999999@anumati",
"dataLife": {
"value": 1,
"unit": "YEAR"
Expand Down
2 changes: 1 addition & 1 deletion content/data/account-aggregator/consent-object.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ Consent object contains the information about all the different types of data th
| `fetchType` | Enum to specify either `ONETIME` or `PERIODIC` fetch of data. | Yes |
| `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 |
| `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 |
| `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 |
| `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 performing AA is selected for consent creation</li> | Yes |
| `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 |
| `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 |
| `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 |
Expand Down
2 changes: 1 addition & 1 deletion content/data/account-aggregator/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ visible_in_sidebar: true

## Account Aggregator

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>
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>

<Callout type="highlight">
Data providers are called Financial Information Providers (FIPs) and data
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Read up more about the the `Detail` object <a href="/data/account-aggregator/con
"consentStart": "2022-01-06T06:23:51.832Z",
"consentExpiry": "2022-04-23T05:44:53.822Z",
"Customer": {
"id": "9999999999@onemoney" // {mobile_number@onemoney}
"id": "9999999999@setu" // {mobile_number@setu}
},
"FIDataRange": {
"from": "2021-04-01T00:00:00Z",
Expand Down Expand Up @@ -107,7 +107,7 @@ Read up more about the the `Detail` object <a href="/data/account-aggregator/con
"consentStart": "2022-01-06T06:23:51.832Z",
"consentExpiry": "2022-04-23T05:44:53.822Z",
"Customer": {
"id": "9999999999@onemoney" // {mobile_number@onemoney}
"id": "9999999999@setu" // {mobile_number@setu}
},
"FIDataRange": {
"from": "2021-04-01T00:00:00Z",
Expand Down Expand Up @@ -289,7 +289,7 @@ If the consent is approved, the Status in the response will be `ACTIVE`. After t
"consentStart": "2022-01-06T06:23:51.832Z",
"consentExpiry": "2022-04-23T05:44:53.822Z",
"Customer": {
"id": "9999999999@onemoney" // {mobile_number@onemoney}
"id": "9999999999@setu" // {mobile_number@setu}
},
"FIDataRange": {
"from": "2021-04-01T00:00:00Z",
Expand Down
2 changes: 1 addition & 1 deletion content/data/account-aggregator/v1/consent-object.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ This consent object carries information about all the different types of data th
| `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 |
| `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 |
| `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 |
| `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 |
| `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 |
| `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) |
| `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` |
| `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 |
Expand Down
4 changes: 2 additions & 2 deletions content/data/account-aggregator/v1/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ visible_in_sidebar: true

## Account Aggregator

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>
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>

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

#### What can you build?

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:
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:

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!
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.
Expand Down

0 comments on commit ebe94fe

Please sign in to comment.