Analyse API(Async)

ASynchronous Flow

The field ‘Async =True” in the request message.

Request Type (API)	Async Value	LastDrop Value	Trident Response
Analyze Request	Async = True	LastDrop = True	Client ID
Result Request	NA	NA	Risk Score
Update Transaction Status Message	NA	NA	Acknowledgement

Trident receives the transaction data.
Trident generates the Client ID unique for every transaction.
Sends the Client ID in response.
After preconfigured time client requests Trident for the risk analysis by consuming the Result API
This request includes the Client ID for identification of that transaction.
Trident evaluates the transaction data by running it through the configured rules and analyzes the risk.
Trident sends the risk analysis result to the client in the response message.
Client sends the feedback by consuming the Update Txn Status API to update the transaction status.
Client receives the acknowledgement from Trident

Analyze” API Call
Request

Client requests Trident for risk analysis.

All the inputs/datapoints related to the transaction can be sent in a single or multiple request.

Single Request - “Async = True” and “Lastdrop = True”. E.g. 3DS 2.0 – Areq message

Multiple Requests

1st request - “Async = True” and “Lastdrop = False”. E.g. 3DS 1.0 Vereq message

Last request – “Async = True” and “Lastdrop = True”. E.g. 3DS 1.0 Pareq message

Response

Trident sends only the Client ID of the transaction in the response.

Note:

If any of the mandatory data-fields in this request are missing the transaction/Request will not be processed and error message will be sent.

Result” API Call

Request:

After the ‘Analyze’ API call, Client requests Trident for the risk score with ‘Result’ API request which contains the ‘ClientId’ of the transaction. This API request can be triggered any time after ‘Analyse’ API request with ‘Lastdrop’ value as true.

The request is for either comprehensive or brief evaluation summary

Comprehensive risk analysis summary (Datafield = ‘details’ = true)

Brief risk analysis summary (Datafield = ‘details’ = false)

Response: Trident responds with the risk analysis of the transaction. The response contains the comprehensive or short evaluation summary for the transaction.

[https://apimanagement.readme.io/reference/transactiontrigerautocsr]

"UpdateTxnStatus” API Call – Feedback
Request:After the transaction completion the client sends the transaction status to Trident by consuming the ‘UpdateTxnStatus’ API.This call contains the ClientId of the transaction, status of the transaction, action taken by the client and the reason for failure in case of transaction failure.

Response

Trident acknowledges the Update Transaction status request.