Login to AIV

/aivlogin

Method : POST
URL : https://xxx.finexusgroup.com/AIV/rest/v1/aivlogin

info

• This method allows the submission of a request from eKYC’s web app for an apiKey to Log into the AIV system using encrypted message that have been signed by the Host.
• licenseKey to be provided by Finexus.

Request

Request Parameters

Field Name	Required	Type	Description	Example
sourceInfo	Yes	Object	Source information.	Refer to explanation below.
interactionMode	Yes	Object	Interaction mode.	Refer to explanation below.
contextInfo	Yes	Object	Context information.	Refer to explanation below.

Object: sourceInfo

Field Name	Required	Type	Description	Example
source	Yes	String	Source.	"FNXCRDS"
partnerId	Yes	String	Partner ID.	"BSSS"
productType	Optional	String	Partner type.	"appTest"
reference	Yes	String	Reference.	"2003160192931"
apiVersion	Yes	String	API version.	"1.6"
apiKey	Conditional	String	API key.	"123-KEJRU-001"
userId	Optional	String	User ID.	"mkchan"
userToken	Optional	String	User token.	"APPOKJSID8J1234"

Object: interactionMode

Field Name	Required	Type	Description	Example
mode	Yes	String	Mode.	"ASYNC"
callbackUrl	Optional	String	Callback URL.

Object: contextInfo

Field Name	Required	Type	Description	Example
ctxSourceInfo	Yes	Object	Context source information.	Refer to explanation below.
licenseKey	Yes	String	License key.	"ASJ123412"
ctxDateTime	Yes	String	Context date time.	"2203161000699"
purpose	Yes	String	Purpose.	"Test"
signature	Yes	String	Signature.	"4C3ACE806CD5F"

Object: ctxSourceInfo

Field Name	Required	Type	Description	Example
source	Yes	String	Source.	"FNXCRDS"
partnerId	Yes	String	Partner ID.	"BSSS"

Response

Response Codes

Response Code	Description	Response Schema
200	The service is able to authenticate and allow the caller to use the service and method.	AIVLoginResponse
400	Bad request whereby the service cannot find the message layout as expected.	NIL
401	Unauthorised access - unable to authenticate source system	NIL
405	Forbidden access - source system is not authorised to perform an action	NIL

Response Parameters

Field Name	Required	Type	Description	Example
status	Yes	Object	Status.	Refer to explanation below.
payload	Optional	Object	AIV login information.	Refer to explanation below.

Object: status

Field Name	Required	Type	Description	Example
sourceInfo	Yes	Object	Source information.	Refer to explanation below.
errorList	Yes	Array Object	Error list.	Refer to explanation below.
status	Yes	String	Status.	"SUCCESS"

Object: sourceInfo

Field Name	Required	Type	Description	Example
source	Yes	String	Source.	"FNXCRDS"
partnerId	Yes	String	Partner ID.	"BSSS"
productType	Optional	String	Partner type.	"appTest"
reference	Yes	String	Reference.	"2003160192931"
apiVersion	Yes	String	API version.	"1.6"
apiKey	Conditional	String	API key.	"123-KEJRU-001"
userId	Optional	String	User ID.	"mkchan"
userToken	Optional	String	User token.	"APPOKJSID8J1234"

Object: errorList

Field Name	Required	Type	Description	Example
msgCode	Yes	String	Message code.	"000"
msgText	Yes	String	Message text.

Object: payload

Field Name	Required	Type	Description	Example
apiKey	Yes	String	API key.	"1233214HSC"

Example Message

Request

/aivlogin POST Request

curl -X POST "https://xxx.finexusgroup.com/AIV/rest/clientauth/aivlogin" \
 -H "Accept: application/json" \
 -H "Content-Type: application/json" \ 
 -d '{
        "sourceInfo": {
            "source": "test",
            "partnerId": "test",
            "apiVersion": "1.6",
            "reference": "e19342b2e6074364bb51af270db71fa6Vc38TdFyPHcCEqg9",
        },
        "interactionMode": {
            "mode": "async"
        },
        "contextInfo": {
            "licenseKey": "ASJ123412",
            "ctxDateTime": "20211201083010",
            "purpose": "Test",
            "ctxSourceInfo": {
                "source": "FNXCRDS",
                "partnerId": "PR"
            },
            "signature": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
        }
    }'

Response

/aivlogin POST Response

{   
"status": {
        "sourceInfo": {
            "source": "test",
            "partnerId": "test",
            "apiVersion": "1.6",
            "reference": "e19342b2e6074364bb51af270db71fa6V9",
            "apiKey": "1F4ABF0D68F49A43A21C6C5F163CAB5"
        },
        "errorList": [
                {
                       "msgText": "",
                       "msgCode": ""
                }
            ],
        "status": "SUCCESS"
    },
    "payload": {
        "apiKey": "1F4ABF0D68F49A43A21C6C5F163CAB5"
    },
}