Link Account Authentication API
This API is used only in the case of token-based authentication for linking accounts. The AA submits the token (received from the customer) to the FIP so that account linkage can be completed. The method is used to submit the token/OTP back to FIP so account linkage can be completed. This is in case the FIP uses a token based authenticator. In case of FID direct authenticator, this method will not be used.
Request Parameters
Parameter Name
Data type
Required?
Description
refNumber
string
Yes
The reference number that was generated by the FIP in response to an accounts link/delink request. The current API enables completion of account link/delink for the accounts specified in that request
Token
string (path)
Yes
The token that was sent to the customer by the FIP to confirm account link/delink activity
Response Parameters
Parameter Name
Data type
Required?
Description
ver
string
Yes
The version of the API. Example: "1.0"
timestamp
string (date-time)
Yes
Creation timestamp of the message which will be updated at each leg. Example: "2018-12-06T11:39:57.153Z"
txnid
string
Yes
An unique transaction identifier used for providing an end to end traceability. Example: "f35761ac-4a18-11e8-96ff-0277a9fbfedc"
AccLinkDetails
A response of confirmation for account link/delink with a link reference number for future identification
  customerAddress
string
No
Example : "customer_address@aa_identifier"
  linkRefNumber
string
No
Example : "xxxxxxxxxxxxx"
  accRefNumber
string
No
Example : "XXXXXXXXXXXXX"
  status
string
No
Example : "LINKED"
Example
Sample Request
{
"refNumber":"xxxxxxxxxxxxx"
"token":"123456"
}
Sample Response
{
"ver": "1.0",
"timestamp": "2018-05-05T10:27:17.699+0000",
"txnid": "410c2d2e-4a1e-11e8-960e-0277a9fbfedc",
"AccLinkDetails": [
{
"customerAddress": "customer_address@aa_identifier",
"linkRefNumber": "xxxxxxxxxxxxx",
"accRefNumber": "XXXXXXXXXXXX",
"status": "LINKED"
}
]
}