The Update Transaction Status API offers the calling application/client to confirm Trident's suggestion and to update the end status of a completed transaction.
Endpoint
Endpoint URL Format: <domainname>/analyse/POS/updateTxnStatus
Example Endpoint URL:
http://localhost:8443/analyse/POS/updateTxnStatus
Method: POST
Content-Type: application/json
Request parameters
Parameter | Description | Example |
---|---|---|
clientId
|
| 201809_86642221-1801-49aa-ad12-c409c0317451. |
finalStatus
|
| 100 - Transaction Success |
Custom parameters | ||
action
|
| 001 - Default action |
reason
|
| 004 - User Decline |
Custom parameters:
Trident supports any number of custom fields to be configured basis the use case.
Sample request
curl -X POST "http://127.0.1:8443/analyse/POS/updateTxnStatus" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"clientId": "201809_12345TXN",
"finalStatus": "100",
"action": "001",
"reason": "004"
}'
Response parameters
Parameter | Description | Example |
---|---|---|
clientId | String (UUID) - Unique transaction ID generated by Trident for tracking purposes. | 20240112103024_8172_3DS_8d77153d-5bd0-4e89-b0d7-86024adbc13e |
reason | String - Reason for failed transaction. | 093 |
NodeId | String - Server node identifier that processed the request. | 172.31.2.145::8443 |
Sample response
{
"clientId": "20240112103024_8172_3DS_8d77153d-5bd0-4e89-b0d7-86024adbc13e",
"reason": "093",
"NodeId": "172.31.2.145::8443"
}