Login

Query For agreementID

This will show how the customer after charging a card using 3DS can query for the agreementID generated

Note the agreementID is only available within an hour from when the transaction is generated where after the 1 hour the data is discarded from Tingg's platform.

Request Parameters

Parameter NameTypeDescription
serviceCodestringUnique code identifier for the merchant's service in use as provided on the checkout platform.
merchantTransactionIDstringUnique transaction ID identifying the transaction as given by the merchant.

Example

{
    "merchantTransactionID": "{{merchantTransactionID}}",
    "serviceCode": "{{service_code}}",
 }   

Response Parameters

Parameter NameTypeDescription
statusCodestringFor success will always be 200 and 0 For failed
statusDescriptionstringDescribe the success or failed status given above
resultsJSONObjectcontains the actual details to be returned
results.tokenstringreturns the actual token generated if you did a generate token with 3DS request
results.agreementIDstringThis will give back the agreementID generated by the acquirer for the transaction

Example of Successful Response

{
    "statusCode": 200,
    "statusDescription": "Successfully processed request!",
    "results": {
        "token": "9538573326597802",
        "agreementID": "39267377884"
    }
}

Example of Failed Responses

{
    "statusCode": 0,
    "statusDescription": "Token not available",
    "results": null
}

{
    "statusCode": 0,
    "statusDescription": "3DS Authentication Failed",
    "results": {
        "acquirerCode": "ERR_3DS",
        "acquirerMessage": "3DS Authentication Failed",
        "merchantTransactionID": "idwe_7430928"
    }
}