{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"93f0aafc-6712-471a-b311-b7c61403379a","name":"Moneyone FinPro","description":"MoneyOne (Fintech Products and Solutions India Pvt. Ltd.) operates as a Technology Service Provider (TSP). One of its offerings, FinPro, is a platform designed to facilitate the onboarding of Financial Information Users (FIUs) into the Account Aggregator (AA) ecosystem.\n\nMoneyone Technology Service Provider (TSP) platform allows an FIU (Financial Information User) to support integration with all authorized Account Aggregators in the ecosystem in a dynamic, yet trusted manner by providing a ready implementation of the latest FIU API specifications published by ReBIT.\n\n**Features of FinPro**\n\n- FinPro enable FIs, NBFCs, Insurance companies and all qualified regulated entities, to participate in the AA ecosystem.\n    \n- It enables all participating organizations to receive data as per RBI regulation and be compliant with it.\n    \n- Provides innovations to make consumer journeys seamless, data usage convenient and compliant.\n    \n\n---\n\n## Prerequisites\n\n- Begin by setting up the FinPro UAT/Production for your FIU with our assistance. Please contact us at [support@moneyone.in ](https://mailto:support@moneyone.in) for any help.\n    \n- You will receive access to the **FinPro** **Admin Portal**.\n    \n- Before proceeding with API testing, please set up the below configuration in FinPro portal:\n    \n    - **Consent template**\n        \n    - **Webhook notification**\n        \n- Our team will provide you with the **API Keys** required to test the APIs. You can also regenerate them in the admin portal.\n    \n    - **Organization ID**\n        \n    - **Client ID**\n        \n    - **Client secret**\n        \n    - **App Identifier**\n        \n\n---\n\n## **Integration Steps**\n\n- FIU raises a consent request for the customer using one of the available Consent Request APIs.\n    \n- FinPro generates a Web Redirection URL against the consent request.\n    \n- FIU navigates the customer to the Web Redirection URL to complete the AA consent journey.\n    \n- The customer reviews the consent request details and either approves or rejects the consent.\n    \n- Once the customer has acted on the consent, FinPro sends a webhook notification to the FIU with the consent status.\n    \n- While configuring the consent template, FIU can set the Data Request Mode as either automatic or manual.\n    \n- In automatic mode, FinPro automatically fetches the data from AA once the consent is approved.\n    \n- In manual mode, FIU must trigger a data fetch request using the FI Request API after the consent is approved.\n    \n- Once the requested data is successfully fetched from AA and ready, FinPro sends a webhook notification to FIU indicating data availability.\n    \n- FIU fetches the customer’s financial data using the Data Management APIs\n    \n\n---\n\n## FinPro Portal Setup\n\nTo get started with the FinPro integration the following would be required:\n\n- Acquire login credentials from Moneyone team for the FinPro Portal.\n    \n- Login to FinPro Portal using username and password\n    \n\n#### Consent Template Configuration\n\n1. Navigate to Consent Templates from the side navigation menu in the FinPro portal.\n    \n2. A table will be displayed listing all the existing Consent Templates.\n    \n3. If there are no Consent Templates available, you will need to create at least one.\n    \n4. To create a new Consent Template, click on the \"Create Consent Template\" button visible on the screen.\n    \n5. Fill in the details in the respective sections:\n    \n    1. Template details such as Purpose code, Template name, etc.\n        \n    2. Consent request details such as Consent validity, consent types, FI types, etc.\n        \n    3. Data request details such as Fetch type, frequency, etc.\n        \n    4. Data filters (optional) based on transaction type or amount.\n        \n\n#### Webhook Notification Configuration\n\nWebhook is a feature to receive notifications for subscribed events.\n\n- Notifications are triggered on completion of the subscribed event.\n    \n- The notification to a subscribed event is sent to a webhook URL setup by the FIU.\n    \n- The notification is sent as a plain string message.\n    \n- When setting up the webhook, you will be asked to specify a secret. Using this secret, you can validate that the webhook is from Moneyone.\n    \n\nFor. e.g., if a webhook has been setup for consent approval event then notification would be sent once a user approves consent.\n\n#### **Setting up of Webhook**\n\n1. Navigate to Admin → Webhooks from the side navigation menu in the FinPro portal.\n    \n2. A table will be displayed listing all the existing Webhooks configured.\n    \n3. To set up a new webhook, fill in the required details and save it.\n    \n    1. Event categories such as Consent-related, Data-related, etc.\n        \n    2. Enter the Webhook URL along with Secret and App Identifier.\n        \n    3. Each event category has a list of events that the FIU can subscribe to. Select the required events.\n        \n\n#### List of Events\n\n| Event | Triggered When |\n| --- | --- |\n| Consent Approve | Triggered by FinPro to FIU when a user approves a raised consent |\n| Consent Reject | Triggered by FinPro to FIU when a user rejects a raised consent |\n| Consent Revoke | Triggered by FinPro to FIU when a user revokes a consent |\n| Consent Expiry | Triggered by FinPro to FIU when an active consent expires |\n| Consent Pause | Triggered by FinPro to FIU when an active consent has been paused by customer |\n| Consent Resume | Triggered by FinPro to FIU when a paused consent has been resumed by customer |\n| Data Request | Triggered by FinPro to FIU when a data request is placed by FinPro to AA |\n| Data Ready | Triggered by FinPro to FIU when the requested data is ready to be shared |\n| Data Push | Triggered by FinPro to FIU to push the financial data to FIU endpoint |\n| Data Denied | Triggered by FinPro to FIU when the requested data has been denied by FIPs |\n| Session Expired | Triggered by FinPro to FIU when the session between FIU and Onemoney expires |\n| Session Failed | Triggered by FinPro to FIU when FIP fails to provide data or delivery fails |\n| Event Status Updated | Triggered by FIU to AA whenever any updates were made in the AA |\n\n#### Mechanism to verify the notification\n\n- Generate a signature by using the secret entered when setting up webhooks using the below code.\n    \n- Generate a X-Webhook-Signature using [https://www.jokecamp.com/blog/examples-of-creating-base64-hashes-using-hmac-sha256-in-different-languages/](https://www.jokecamp.com/blog/examples-of-creating-base64-hashes-using-hmac-sha256-in-different-languages/)\n    \n- Secret is what FIU has configured in the FinPro portal. After secret is generated, the generated signature and the X-Webhook-Signature from request header matches, the data is said to be coming from the correct source.\n    \n- Use the below code to verify that the notification is coming from Moneyone server and to generate signature\n    \n\n```\nrequests.get(url, headers={‘X-Webhook-Signature’: })\n\n ```\n\n#### Sample Format\n\n``` json\n{\n\"timestamp\": \"<timestamp>\",\n\"consentHandle\": \"<consent handle value>\",\n\"eventType\": \"<event type>\",\n\"eventStatus\": \"<event status>\",\n\"consentId\": \"<consent id>\",\n\"eventMessage\": \"<event message>\"\n}\n\n ```\n\n##### CONSENT_APPROVED – TYPE 1\n\n``` json\n{\n\"timestamp\":\"2022-03-08T12:21:43.616Z\",\n\"consentHandle\":\"c7f0d368-a05f-468d-8d6c-c75acc17f224\",\n\"eventType\":\"CONSENT\",\n\"eventStatus\":\"CONSENT_APPROVED\",\n\"consentId\":\"bf0cda0b-776c-4104-a4f8-5bcd69764125\",\n\"vua\":\"9999999999@onemoney\",\n\"eventMessage\":\"Consent approved for consent id bf0cda0b-776c-4104-a4f8-5bcd69764125\"\n}\n\n ```\n\n##### CONSENT_APPROVED – TYPE 2\n\n``` json\n{\n   \"timestamp\":\"2023-03-10T06:26:02.035Z\",\n   \"consentHandle\":\"5eada97a-9852-4227-9558-45849b2800a3\",\n   \"eventType\":\"CONSENT\",\n   \"eventStatus\":\"CONSENT_APPROVED\",\n   \"consentId\":\"3c92001e-57ea-4320-bbb8-66d524bfb435\",\n   \"vua\":\"XXXXXXX773@onemoney\",\n   \"eventMessage\":\"Consent approved for consent id 3c92001e-57ea-4320-bbb8-66d524bfb435\",\n   \"productID\":\"AGENT\",\n   \"accountID\":\"AGENT1678429501561\",\n   \"fetchType\":\"ONETIME\",\n   \"consentExpiry\":\"2023-03-11 06:25:13\"\n}\n\n ```\n\n##### CONSENT_PAUSED – TYPE 1\n\n``` json\n{\n   \"timestamp\":\"2022-03-08T12:24:40.836Z\",\n   \"consentHandle\":\"c7f0d368-a05f-468d-8d6c-c75acc17f224\",\n   \"eventType\":\"CONSENT\",\n   \"eventStatus\":\"CONSENT_PAUSED\",\n   \"consentId\":\"bf0cda0b-776c-4104-a4f8-5bcd69764125\",\n   \"vua\":\"9999999999@onemoney\",\n   \"eventMessage\":\"Consent paused for consent id bf0cda0b-776c-4104-a4f8-5bcd69764125\"\n}\n\n ```\n\n##### CONSENT_PAUSED – TYPE 2\n\n``` json\n{\n   \"timestamp\":\"2023-03-10T06:29:11.246Z\",\n   \"consentHandle\":\"5eada97a-9852-4227-9558-45849b2800a3\",\n   \"eventType\":\"CONSENT\",\n   \"eventStatus\":\"CONSENT_PAUSED\",\n   \"consentId\":\"3c92001e-57ea-4320-bbb8-66d524bfb435\",\n   \"vua\":\"XXXXXXX773@onemoney\",\n   \"eventMessage\":\"Consent paused for consent id 3c92001e-57ea-4320-bbb8-66d524bfb435\",\n   \"productID\":\"AGENT\",\n   \"accountID\":\"AGENT1678429501561\",\n   \"fetchType\":\"ONETIME\",\n   \"consentExpiry\":\"2023-03-11 06:25:13\"\n}\n\n ```\n\n##### CONSENT_RESUMED – TYPE 1\n\n``` json\n{\n   \"timestamp\":\"2022-03-08T12:25:18.377Z\",\n   \"consentHandle\":\"c7f0d368-a05f-468d-8d6c-c75acc17f224\",\n   \"eventType\":\"CONSENT\",\n   \"eventStatus\":\"CONSENT_RESUMED\",\n   \"consentId\":\"bf0cda0b-776c-4104-a4f8-5bcd69764125\",\n   \"vua\":\"9999999999@onemoney\",\n   \"eventMessage\":\"Consent reactivated for consent id bf0cda0b-776c-4104-a4f8-5bcd69764125\"\n}\n\n ```\n\n##### CONSENT_RESUMED – TYPE 2\n\n``` json\n{\n   \"timestamp\":\"2023-03-10T06:29:49.212Z\",\n   \"consentHandle\":\"5eada97a-9852-4227-9558-45849b2800a3\",\n   \"eventType\":\"CONSENT\",\n   \"eventStatus\":\"CONSENT_RESUMED\",\n   \"consentId\":\"3c92001e-57ea-4320-bbb8-66d524bfb435\",\n   \"vua\":\"XXXXXXX773@onemoney\",\n   \"eventMessage\":\"Consent reactivated for consent id 3c92001e-57ea-4320-bbb8-66d524bfb435\",\n   \"productID\":\"AGENT\",\n   \"accountID\":\"AGENT1678429501561\",\n   \"fetchType\":\"ONETIME\",\n   \"consentExpiry\":\"2023-03-11 06:25:13\"\n}\n\n ```\n\n##### CONSENT_REVOKED – TYPE 1\n\n``` json\n{\n   \"timestamp\":\"2022-03-08T12:25:55.476Z\",\n   \"consentHandle\":\"c7f0d368-a05f-468d-8d6c-c75acc17f224\",\n   \"eventType\":\"CONSENT\",\n   \"eventStatus\":\"CONSENT_REVOKED\",\n   \"consentId\":\"bf0cda0b-776c-4104-a4f8-5bcd69764125\",\n   \"vua\":\"9999999999@onemoney\",\n   \"eventMessage\":\"Consent revoked for consent id bf0cda0b-776c-4104-a4f8-5bcd69764125\"\n}\n\n ```\n\n##### CONSENT_REVOKED – TYPE 2\n\n``` json\n{\n   \"timestamp\":\"2023-03-10T06:31:49.092Z\",\n   \"consentHandle\":\"5eada97a-9852-4227-9558-45849b2800a3\",\n   \"eventType\":\"CONSENT\",\n   \"eventStatus\":\"CONSENT_REVOKED\",\n   \"consentId\":\"3c92001e-57ea-4320-bbb8-66d524bfb435\",\n   \"vua\":\"XXXXXX773@onemoney\",\n   \"eventMessage\":\"Consent revoked for consent id 3c92001e-57ea-4320-bbb8-66d524bfb435\",\n   \"productID\":\"AGENT\",\n   \"accountID\":\"AGENT1678429501561\",\n   \"fetchType\":\"ONETIME\",\n   \"consentExpiry\":\"2023-03-11 06:25:13\"\n}\n\n ```\n\n##### CONSENT_REJECTED – TYPE 1\n\n``` json\n{\n  \"timestamp\": \"2020-12-18T09:58:12.162Z\",\n  \"consentHandle\": \"26a9b8a5-9396-47d5-a37e-b09b95740337\",\n  \"eventType\": \"CONSENT\",\n  \"eventStatus\": \"CONSENT_REJECTED\",\n  \"consentId\": \"<NULL>\",\n  \"eventMessage\": \"Consent rejected for consent id <NULL>\"\n}\n\n ```\n\n##### CONSENT_REJECTED – TYPE 2\n\n``` json\n{\n   \"timestamp\":\"2023-03-10T07:06:51.513Z\",\n   \"consentHandle\":\"b3bf17ec-9431-4def-be7d-48cffe2ef491\",\n   \"eventType\":\"CONSENT\",\n   \"eventStatus\":\"CONSENT_REJECTED\",\n   \"consentId\":\"\",\n   \"vua\":\"7730808773@onemoney\",\n   \"eventMessage\":\"Consent is rejected\",\n   \"productID\":\"AGENT\",\n   \"accountID\":\"AGENT1678431946347\",\n   \"fetchType\":\"ONETIME\",\n   \"consentExpiry\":\"2023-03-11 07:05:51\"\n}\n\n ```\n\n##### CONSENT_EXPIRED – TYPE 1\n\n``` json\n{\n  \"timestamp\": \"2022-03-31T04:38:22.720Z\",\n  \"consentHandle\": \"b600d92b-36ba-45d3-a42a-5fac53fabe87\",\n  \"eventType\": \"CONSENT\",\n  \"eventStatus\": \"CONSENT_EXPIRED\",\n  \"consentId\": \"6d867fc2-24bd-4b89-b9fe-fefbb076cbd2\",\n  \"vua\": \"9999999999@onemoney\",\n  \"eventMessage\": \"Consent expired for consent id 6d867fc2-24bd-4b89-b9fe-fefbb076cbd2\"\n}\n\n ```\n\n##### CONSENT_EXPIRED – TYPE 2\n\n``` json\n{\n   \"timestamp\":\"2023-03-11 07:09:51\",\n   \"consentHandle\":\"3b14393a-ccb7-4df9-aad4-01634c909e45\",\n   \"eventType\":\"CONSENT\",\n   \"eventStatus\":\"CONSENT_EXPIRED\",\n   \"consentId\":\"37c176a2-85a2-49df-924f-69ebb74df7a2\",\n   \"vua\":\"XXXXXX499@onemoney\",\n   \"eventMessage\":\"Consent expired for consent id 37c176a2-85a2-49df-924f-69ebb74df7a2\",\n   \"productID\":\"RGS0002\",\n   \"accountID\":\"888\",\n   \"fetchType\":\"ONETIME\",\n   \"consentExpiry\":\"2023-03-11 07:09:51\"\n}\n\n ```\n\n##### DATA_REQUEST – TYPE 1\n\n``` json\n{\n   \"timestamp\":\"2022-03-08T12:22:03.146Z\",\n   \"consentHandle\":\"c7f0d368-a05f-468d-8d6c-c75acc17f224\",\n   \"eventType\":\"DATA\",\n   \"eventStatus\":\"DATA_REQUEST\",\n   \"consentId\":\"bf0cda0b-776c-4104-a4f8-5bcd69764125\",\n   \"vua\":\"9999999999@onemoney\",\n   \"eventMessage\":\"Data Requested for consent id bf0cda0b-776c-4104-a4f8-5bcd69764125\",\n}\n\n ```\n\n##### DATA_READY – TYPE 1\n\n``` json\n{\n   \"timestamp\":\"2022-03-08T12:22:03.146Z\",\n   \"consentHandle\":\"c7f0d368-a05f-468d-8d6c-c75acc17f224\",\n   \"eventType\":\"DATA\",\n   \"eventStatus\":\"DATA_READY\",\n   \"consentId\":\"bf0cda0b-776c-4104-a4f8-5bcd69764125\",\n   \"vua\":\"9999999999@onemoney\",\n   \"eventMessage\":\"Data ready for consent id bf0cda0b-776c-4104-a4f8-5bcd69764125\",\n   \"linkRefNumbers\":[\n      {\n         \"linkRefNumber\":\"e7597a05-5b56-4223-95fc3f-9596ff12eb\",\n         \"fiStatus\":\"READY\"\n      }\n   ]\n}\n\n ```\n\n##### DATA_READY – TYPE 2\n\n``` json\n{\n   \"timestamp\":\"2023-03-10T06:26:10.823Z\",\n   \"consentHandle\":\"5eada97a-9852-4227-9558-45849b2800a3\",\n   \"eventType\":\"DATA\",\n   \"eventStatus\":\"DATA_READY\",\n   \"consentId\":\"3c92001e-57ea-4320-bbb8-66d524bfb435\",\n   \"vua\":\"XXXXXXX773@onemoney\",\n   \"eventMessage\":\"Data ready for consent id 3c92001e-57ea-4320-bbb8-66d524bfb435\",\n   \"productID\":\"AGENT\",\n   \"accountID\":\"AGENT1678429501561\",\n   \"fetchType\":\"ONETIME\",\n   \"consentExpiry\":\"2023-03-11 06:25:13\",\n   \"dataExpiry\":\"2023-04-10T06:26:10.000Z\",\n   \"firstTimeFetch\":true,\n   \"linkRefNumbers\":[\n      {\n         \"linkRefNumber\":\"70814726-f02e-4db4-b380-df8d28ec6772\",\n         \"fiStatus\":\"READY\",\n         \"fipName\":\"FinShareBankServer\",\n         \"fipId\":\"finsharebank\",\n         \"maskedAccountNumber\":\"XXXXXXXX7300\"\n      }\n   ]\n}\n\n ```\n\n##### SESSION_FAILED – TYPE 1\n\n``` json\n{\n   \"timestamp\":\"2022-04-07T07:28:37.485Z\",\n   \"consentHandle\":\"995bad77-a003-402e-9b0d-8602c4069ef7\",\n   \"eventType\":\"DATA\",\n   \"eventStatus\":\"SESSION_FAILED\",\n   \"consentId\":\"48ecb1ed-3256-463f-b9a9-7936a1bb6f79\",\n   \"vua\":\"9999999999@onemoney\",\n   \"eventMessage\":\"Data fetch failed for consent id 48ecb1ed-3256-463f-b9a9-7936a1bb6f79\",\n   \"linkRefNumbers\":[\n      {\n         \"linkRefNumber\":\"5845ad3b-ae9d-435b-99fb-cc7462300706\",\n         \"fiStatus\":\"TIMEOUT\"\n      }\n   ]\n}\n\n ```\n\n##### SESSION_FAILED – TYPE 2\n\n``` json\n{\n   \"timestamp\": \"2023-09-28T06: 38: 37.886Z\",\n   \"consentHandle\": \"f18714e0-001b-44ac-8c85-c3162c434516\",\n   \"eventType\": \"DATA\",\n   \"eventStatus\": \"SESSION_FAILED\",\n   \"consentId\": \"59994ced-2620-4b12-9bd8-35025588887c\",\n   \"vua\": \"9999999999@onemoney\",\n   \"eventMessage\": \"Data fetch failed for consent id 59994ced-2620-4b12-9bd8-35025588887c\",\n  \"productID\": \"TESTP\",\n  \"accountID\": \"TESTP1695813566525\",\n  \"fetchType\": \"PERIODIC\",\n  \"consentExpiry\": \"2024-09-27 11: 19: 34\",\n  \"dataExpiry\": \"2023-09-28T11: 22: 12.000Z\",\n  \"sessionId\": \"728714aa-4fe3-430a-bd26-796ceea3de7d\",\n  \"linkRefNumbers\": [\n     {\n    \"linkRefNumber\": \"cfe39ed2-0b92-4720-98a7-ffe03e3fbc13\",\n    \"fiStatus\": \"TIMEOUT\",\n    \"fipName\": \"FinShareBankServer\",\n    \"fipId\": \"finsharebank\",\n    \"maskedAccountNumber\": \"XXXXXXXX0600\"\n     }\n   ]\n}\n\n ```\n\n##### SESSION_EXPIRED – TYPE 1\n\n``` json\n{\n   \"timestamp\":\"2021-04-23T13:08:01.514Z\",\n   \"consentHandle\":\"825da2f2-ae80-469b-b69b-6fb428107500\",\n   \"eventType\":\"DATA\",\n   \"eventStatus\":\"SESSION_EXPIRED\",\n   \"consentId\":\"91a2bb4c-8197-42c5-8de3-4ba02c16196d\",\n   \"vua\":\"9999999999@onemoney\",\n   \"eventMessage\":\"Data fetch expired for consent id 91a2bb4c-8197-42c5-8de3-4ba02c16196d\"\n}\n\n ```\n\n##### DATA_DENIED – TYPE 1\n\n``` json\n{\n   \"timestamp\":\"2022-04-07T06:33:28.592Z\",\n   \"consentHandle\":\"91c1cc00-e98b-4ee1-8b69-5afbae03f6b3\",\n   \"eventType\":\"DATA\",\n   \"eventStatus\":\"DATA_DENIED\",\n   \"consentId\":\"2f93c7f3-5fc5-479c-bea2-dfdac731b159\",\n   \"vua\":\"9999999999@onemoney\",\n   \"eventMessage\":\"Data denied for consent id 2f93c7f3-5fc5-479c-bea2-dfdac731b159\",\n   \"linkRefNumbers\":[\n      {\n         \"linkRefNumber\":\"efc18641-62c1-4706-a84c-dd86ea87f528\",\n         \"fiStatus\":\"DENIED\"\n      }\n   ]\n}\n\n ```\n\n##### DATA_DENIED – TYPE 2\n\n``` json\n{\n   \"timestamp\":\"2023-02-23T12:26:28.548Z\",\n   \"consentHandle\":\"60ff809a-61b6-4959-bb4a-81cb44ac1f51\",\n   \"eventType\":\"DATA\",\n   \"eventStatus\":\"DATA_DENIED\",\n   \"consentId\":\"d2277986-a5cc-42c2-89cd-b8f4018dc309\",\n   \"vua\":\"XXXXXXX773@onemoney\",\n   \"eventMessage\":\"Data denied for consent id d2277986-a5cc-42c2-89cd-b8f4018dc309\",\n   \"productID\":\"TESTONFEB17\",\n   \"accountID\":\"1234\",\n   \"fetchType\":\"PERIODIC\",\n   \"consentExpiry\":\"2023-02-25 12:14:41\",\n   \"dataExpiry\":\"\",\n   \"linkRefNumbers\":[\n      {\n         \"linkRefNumber\":\"65a13110-d1db-4703-960b-39f7e02e7b23\",\n         \"fiStatus\":\"DENIED\",\n         \"fipName\":\"FinShareBankServer\",\n         \"fipId\":\"finsharebank\",\n         \"maskedAccountNumber\":\"XXXXXXXX7300\"\n      },\n      {\n         \"linkRefNumber\":\"65a13110-d1db-4703-960b-39f7e02e7b23\",\n         \"fiStatus\":\"DENIED\",\n         \"fipName\":\"FinShareBankServer\",\n         \"fipId\":\"finsharebank\",\n         \"maskedAccountNumber\":\"XXXXXXXX7300\"\n      }\n   ]\n}\n\n ```\n\n##### DATA_PUSH – TYPE 1\n\n``` json\n{\n  \"timestamp\": \"2022-04-07T06:10:17.129Z\",\n  \"consentHandle\": \"7793263e-ab71-4343-8f31-e7e695f4a3d1\",\n  \"eventType\": \"DATA_EXT\",\n  \"eventStatus\": \"DATA_PUSH\",\n  \"consentId\": \"bd740c63-70a3-415a-944f-fc6b16e2c55f\",\n  \"vua\": \"7730808773@onemoney\",\n  \"eventMessage\": \"Data push for consent id bd740c63-70a3-415a-944f-fc6b16e2c55f\",\n  \"productID\": \"AGENT\",\n  \"accountID\": \"AGENT1678429501561\",\n  \"fetchType\": \"ONETIME\",\n  \"consentExpiry\": \"2023-03-11 06:25:13\",\n  \"dataExpiry\": \"2023-04-10T06:26:10.000Z\",\n  \"firstTimeFetch\": true,\n  \"linkRefNumbers\": [\n    {\n      \"linkRefNumber\": \"70814726-f02e-4db4-b380-df8d28ec6772\",\n      \"fiStatus\": \"READY\",\n      \"fipName\": \"FinShareBankServer\",\n      \"fipId\": \"finsharebank\",\n      \"maskedAccountNumber\": \"XXXXXXXX7300\"\n    }\n  ],\n  \"data\": [\n    {\n      \"linkReferenceNumber\": \"b520384b-7174-4951-98cf-b09574266e61\",\n      \"maskedAccountNumber\": \"XXXXXX8773\",\n      \"fiType\": \"RECURRING_DEPOSIT\",\n      \"bank\": \"FinShareBankServer\",\n      \"Summary\": {\n        \"branch\": \"JayaNagar 4th Block\",\n        \"openingDate\": null,\n        \"ifsc\": \"ICIC0001124\",\n        \"accountType\": \"RECURRING\",\n        \"maturityAmount\": \"61693.00\",\n        \"maturityDate\": null,\n        \"description\": \"12 Months Recurring Deposit\",\n        \"interestPayout\": \"OnMaturity\",\n        \"interestRate\": \"5.15\",\n        \"principalAmount\": \"5000.00\",\n        \"tenureDays\": \"0\",\n        \"tenureMonths\": \"12\",\n        \"tenureYears\": \"0\",\n        \"recurringAmount\": \"5000.00\",\n        \"recurringDepositDay\": \"22\",\n        \"interestComputation\": \"COMPOUND\",\n        \"compoundingFrequency\": \"MONTHLY\",\n        \"interestPeriodicPayoutAmount\": \"0\",\n        \"interestOnMaturity\": \"1693\",\n        \"currentValue\": \"35000.00\"\n      },\n      \"Profile\": {\n        \"Holders\": {\n          \"type\": \"SINGLE\",\n          \"Holder\": [\n            {\n              \"name\": \"Akshay Kumar\",\n              \"dob\": \"1947-08-15\",\n              \"mobile\": \"7730808773\",\n              \"nominee\": \"REGISTERED\",\n              \"landline\": \"\",\n              \"address\": \"8/1190, 5th Cross, 3rd Main, 7th Block, Jayanagar, Bangalore - 560011\",\n              \"email\": \"mail@mail.com\",\n              \"pan\": \"AAAAA0000A\",\n              \"ckycCompliance\": \"true\"\n            }\n          ]\n        }\n      },\n      \"Transactions\": {\n        \"startDate\": \"2019-04-07\",\n        \"endDate\": \"2022-04-07\",\n        \"Transaction\": [\n          {\n            \"type\": \"OPENING\",\n            \"mode\": \"FT\",\n            \"amount\": \"5000.00\",\n            \"balance\": \"5000.00\",\n            \"transactionDateTime\": \"2019-12-22T04:53:45.000Z\",\n            \"valueDate\": \"2019-12-22T04:53:45.000Z\",\n            \"txnId\": \"M2587459\",\n            \"narration\": \"TOWARDS RD OPENING\",\n            \"reference\": \"RFN0001338754\"\n          },\n          {\n            \"type\": \"INSTALLMENT\",\n            \"mode\": \"FT\",\n            \"amount\": \"5000.00\",\n            \"balance\": \"10000.00\",\n            \"transactionDateTime\": \"2020-01-22T04:53:45.000Z\",\n            \"valueDate\": \"2020-01-22T04:53:45.000Z\",\n            \"txnId\": \"M5874125\",\n            \"narration\": \"TOWARDS RD INSTALLMENT\",\n            \"reference\": \"RFN0001587864\"\n          },\n          {\n            \"type\": \"INSTALLMENT\",\n            \"mode\": \"FT\",\n            \"amount\": \"5000.00\",\n            \"balance\": \"15000.00\",\n            \"transactionDateTime\": \"2020-02-22T04:53:45.000Z\",\n            \"valueDate\": \"2020-02-22T04:53:45.000Z\",\n            \"txnId\": \"M9160791\",\n            \"narration\": \"TOWARDS RD INSTALLMENT\",\n            \"reference\": \"RFN0001836974\"\n          }\n        ]\n      }\n    }\n  ]\n}\n\n ```\n\n##### EVENT_STATUS_UPDATED - TYPE 1\n\n``` json\n{ \n\"timestamp\": \"2022-05-27T05:13:57.672Z\", \n\"eventType\": \"AA_LIST\", \n\"eventStatus\": \"EVENT_STATUS_UPDATED\", \n\"eventMessage\": \"There were new updates in AA list, Please take latest \npull from our FIU platform\" \n}\n\n ```\n\n---\n\n## API Sequence\n\n<u><b>Consent Flow</b></u>\n\n- **Consent Request API :** To raise consent request. Use only one of the provided APIs as per the requirement. Please refer to the Consent Management section.\n    \n- **Web Redirection Encryption API (Optional) :** To generate an encrypted url of the account aggregator for a particular consent.\n    \n- **Web Redirection Decryption API (Optional) :** To decrypt the encrypted consent response from AA.\n    \n- **Consent List API (Optional) :** To get the list of consent artefact. Alternatively, FIU can setup Consent level webhook (in admin portal) to receive notification whenever consent status gets updated.\n    \n\n<u><b>Data Flow</b></u>\n\n- **FI Request API (Conditional) :** If fetch mode for the particular consent is set as Manual then this API should be called to initiate a data request.  \n    Note (i): For Auto Manual mode, the first data request will be automatically initiated by FinPro. But from the second data request, FIU has to call this API.\n    \n- **FI Request Status API (Conditional & Optional) :** To check the status of the data request made. Alternatively, FIU can setup Data Ready webhook (in admin portal) to receive notification once the data is fetched from AA and is ready for consumption.\n    \n- There are **multiple FI Data APIs** that the FIU can use as per the requirement. Please refer to the Datam Management section.\n    \n\n<u><b>Additional APIs</b></u>\n\n- **Revoke Consent API :** The FIU can revoke any active consent using this API.\n    \n- **Check Profile API :** To check if the user has an existing profile with the corresponding AA (i.e., VUA exists or not).\n    \n\n<img src=\"https://content.pstmn.io/1f20039b-06b5-4098-923a-438b86b3dbf7/RklVX19GaW5Qcm9fX0FBIERhdGEgRmxvdyBEaWFncmFtIC0gRnJhbWUgMS5qcGc=\">\n\n## API Status Code Catalogue\n\n| Status Code | Status | Description |\n| --- | --- | --- |\n| 400 | Bad Request | This message occurs as a response to the API call made, when a required parameter is missing or an improper request body is sent in the payload of API. |\n| 400 | Bad request headers | This message occurs as a response to the API call made, when request headers are unavailable. |\n| 400 | Invalid URI | This message occurs as a response to the API call made when the API call couldn’t parse the specified URI/Endpoint. |\n| 401 | UNAUTHORIZED_ACCESS | This message occurs as a response to the API call made, when the given token doesn’t have enough permission to make that API call or the token is expired. |\n| 403 | AccessDenied | This message occurs as a response to the API call made, in case when the Web server forbids the user from accessing the API. |\n| 404 | NoSuchVersion | This message occurs as a response to the API call made, when the `ver` parameter value in the request body is incorrect. |\n| 404 | RECORD_NOT_FOUND | This message occurs as a response to the API call made, when the record could not be found for the given request. |\n| 405 | MethodNotAllowed | This message occurs as a response to the API call made, when the specified API method used is not allowed against the API used. |\n| 409 | CONFLICT | This message occurs as a response to the API call made, when the request could not be processed because of a conflict in the request, such as the requested resource not being in the expected state, or the result of processing the request would create a conflict within the resource. |\n| 411 | MissingContentLength | This message occurs as a response to the API call made, when the header of the request body doesn’t contain content-length. |\n| 412 | PRECONDITION_FAILED | This message occurs as a response to the API call made, when the server does not meet one of the preconditions that the client put in its request header fields. |\n| 415 | UnsupportedMediaType | This message occurs as a response to the API call made, when the payload is not a JSON structure. |\n| 500 | InternalError | This message occurs as a response to the API call made, when there is an internal error with Moneyone. |\n| 501 | NOT_IMPLEMENTED | This message occurs as a response to the API call made, when the server does not support the functionality required to fulfill the request. |\n| 502 | BadGateway | This message occurs as a response to the API call made, when there is no valid response from the Onemoney web server. |\n| 503 | SERVICE_UNAVAILABLE | This message occurs as a response to the API call made, when not being able to connect to FIU. |\n| 503 | ERR_CONNECT_SERVICE | This message occurs as a response to the API call made, when the Moneyone server is not able to connect to SQS. |\n| 504 | GATEWAY_TIMEOUT | This message occurs as a response to the API call made, when there is no response from the Moneyone server on time. |\n| 520 | ERR_UNKNOWN | This message occurs as a response to the API call made, due to a variety of unexpected reasons. |\n\n**Note Below:**\n\nThe FinPro API details are provided below. Please use the APIs as per your requirements. Review the _Description_ section of each API to understand its purpose.\n\n- API-level parameter validations (such as length, data type) are included wherever applicable. If validation is not mentioned, it means no additional validation exists.\n    \n- Supported values are specified wherever applicable.\n    \n- Error messages can come enclosed in square brackets \\[\\].","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"12076903","team":1174515,"collectionId":"93f0aafc-6712-471a-b311-b7c61403379a","publishedId":"TVYAfLCm","public":true,"publicUrl":"https://documenter-api.postman.tech/view/12076903/TVYAfLCm","privateUrl":"https://go.postman.co/documentation/12076903-93f0aafc-6712-471a-b311-b7c61403379a","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"00B140"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/4c1c2f69-634c-4f95-90f1-7b67cd0db22b/bW9uZXlvbmUgbGlnaHQgbG9nbyBwbmcucG5n","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"00B140"}},{"name":"light","logo":"https://content.pstmn.io/8d98e86e-616d-45ee-bf04-23fff28c5f59/bW9uZXlvbmUgbG9nby5wbmc=","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"00B140"}}]}},"version":"8.10.1","publishDate":"2025-03-25T17:44:35.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/8d98e86e-616d-45ee-bf04-23fff28c5f59/bW9uZXlvbmUgbG9nby5wbmc=","logoDark":"https://content.pstmn.io/4c1c2f69-634c-4f95-90f1-7b67cd0db22b/bW9uZXlvbmUgbGlnaHQgbG9nbyBwbmcucG5n"}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/bd879d97566720112280147127a7584afe6c44ceeccd7225ad89b4031be69077","favicon":"https://res.cloudinary.com/postman/image/upload/v1596719191/team/fvxulob0ab00fxgosnhr.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://documenter.gw.postman.com/view/metadata/TVYAfLCm"}