AA Endpoints are the list of endpoints that you will be calling from your FIU system to create consent and fetch data from AA.
Please refer the FIU API Spec (2.0.0) https://api.rebit.org.in/spec/aa in the ReBIT to implement the responses for different cases. The APIs below only has success response.
Create JWS and Sign API Request
The API calls to AA ReBIT api's should have x-jws-signature in the header which is a detached JWS of the body.
Here you can find how to create JWS keys for creating the x-jws-signature and refer AA Commons Documentation for how to sign the request that you send to AA and verify the request that you receive from AA.
Consent Creation
You need to raise a consent to Saafe using /Consent API
POSThttps://sandbox.saafe.in/api/v2/Consent
Request
Header
Key
Value
x-jws-signature
string
client_api_key
string
Body
{"ver":"2.0.0","timestamp":"2024-05-09T15:23:55.384Z","txnid":"644d2aff-e43b-4bb9-9047-498cbb9896d2","ConsentDetail": {"consentStart":"2024-05-09T15:23:55.384Z","consentExpiry":"2025-01-01T00:00:00.000Z","consentMode":"STORE","fetchType":"PERIODIC","consentTypes": ["PROFILE","TRANSACTIONS","SUMMARY" ],"fiTypes": ["DEPOSIT" ],"DataConsumer": {"id":"central-trust-uat",// Your FIU Entity ID"type":"FIU" },"Customer": {"Identifiers": [ {"type":"MOBILE","value":"9944612241"//Customer Phone Number } ] },"Purpose": {"code":"101","refUri":"https://api.rebit.org.in/aa/purpose/101.xml","text":"To provide your asset insights","Category": {"type":"Personal Finance" } },"FIDataRange": {"from":"2023-01-01T00:00:00.000Z","to":"2025-01-01T00:00:00.000Z" },"DataLife": {"unit":"YEAR","value":3 },"Frequency": {"unit":"DAY","value":10 } }}
digitalSignature is the signature part of the signedConsent which needs to sent to the AA to make the FI Request.
KeyMaterial Contains the cryptographic parameters that are required to perform End-to-End encryption for sharing the financial information between the producer and the consumer in a secure manner. Ref End-to-end Encryption on implementing the ECDH
Request
Header
Key
Value
x-jws-signature
string
client_api_key
string
Body
{"ver":"2.0.0","timestamp":"2024-05-09T18:29:21.158Z","txnid":"c5e74a42-36c4-4f7b-b85d-4e59871a3f5e","FIDataRange": {"from":"2024-05-05T00:00:00.000Z","to":"2024-05-07T00:00:00.000Z" },"Consent": {"id":"5278f924-2d15-4726-a974-2465cbf48d5c", "digitalSignature": "GTx9lqyavTIDSUVWcua_37D7SxTEASa688YnQYcg61bWSIc_teQGw-Te9APy63EtvA7Hc27B-gtTWIN2zFfexAKVNoF7tKL7E118IScc6F7ToPlPxNFALliRCxnAKKljYhYoIuAYuUcZDiER3okssjk4S_YMVjuLIeexzy84pVH2Y_OZwCJVXiE-mK87lcnv1M5Q1S3WCX1OxU_M5QsfKVnPmjTg9JfvIHO8rLSYS7zRXy-A5fiOEdQKAhM1KOhnMF653fWuMTqL2FoAgenUdnodZgNyFkwcuuCv--7e6tghFUEK2G1tbVHKxJK_X1aIJ2STGXIgS9oLpvOyuFxgNw"
},"KeyMaterial": {"cryptoAlg":"ECDH","curve":"Curve25519","params":"","DHPublicKey": {"expiry":"2024-05-10T18:26:49.031Z","Parameters":"", "KeyValue": "-----BEGIN PUBLIC KEY-----MIIBMTCB6gYHKoZIzj0CATCB3gIBATArBgcqhkjOPQEBAiB/////////////////////////////////////////7TBEBCAqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqYSRShRAQge0Je0Je0Je0Je0Je0Je0Je0Je0Je0Je0JgtenHcQyGQEQQQqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq0kWiCuGaG4oIa04B7dLHdI0UySPU1+bXxhsinpxaJ+ztPZAiAQAAAAAAAAAAAAAAAAAAAAFN753qL3nNZYEmMaXPXT7QIBCANCAARrS/CNE3TmgabxB9KupD1FN4L4weI7cqx+zjkqZcJEfDY22ar/e8t9tYWKcH1T0Q23h0adHoiIKipIZr2O5j3r-----END PUBLIC KEY-----"
},"Nonce":"JRsHMYjdy8qENzydIf3iYFks+XgaZeckzsVjl9n1Xxs=" }}