Validating a Challenge When Using a TMS Token
Running the Validation service compares the customer's response to the challenge from the issuing bank to
validate the customer identity.
Card-Specific Requirements
Some payment cards require additional information to be collected during a
transaction.
- This field is recommended for Discover ProtectBuy.
- This field is required when the card type is Cartes Bancaires.
- This field is required for American Express SafeKey (US) when the product code isAIRfor an airlinepurchase).
- This field is required for Visa Secure travel.
- This field is required only for American Express SafeKey (US).
- This field is required only for American Express SafeKey (US)
Country-Specific Requirements
These fields are required for transactions in specific countries.
- This field is required for transactions processed in France.
- This field is required for transactions in the US and Canada.
- This field is required for transactions in the US and Canada.
- This field is required when theorderInformation.billTo.countryfield value isUSorCA.
Endpoint
Production:
POST
https://api.cybersource.com
/risk/v1/authentication-resultsTest:
POST
https://apitest.cybersource.com
/risk/v1/authentication-resultsRequired Fields for Validating a Challenge When Using a
TMS Token
These fields are the minimum fields required when you request the Payer Authentication Validation
service. Other fields that can be used to collect additional information during a
transaction are listed in the optional fields section. Under certain circumstances,
a field that normally is optional might be required. The circumstance that makes an
optional field required is noted.
Required Fields
REST Example: Validating a Challenge When Using a TMS Token
Request
{ "clientReferenceInformation": { "code": "pavalidatecheck", "partner": { "developerId": "7891234", "solutionId": "89012345" } }, "consumerAuthenticationInformation": { "authenticationTransactionId": "z7BruZ1qn416WGknmAX0" } }
Response to a Successful Request
{ "clientReferenceInformation": { "code": "pavalidatecheck", "partner": { "developerId": "7891234", "solutionId": "89012345" } }, "consumerAuthenticationInformation": { "indicator": "vbv", "eciRaw": "05", "authenticationResult": "0", "strongAuthentication": { "OutageExemptionIndicator": "0" }, "authenticationStatusMsg": "Success", "eci": "05", "token": "AxijLwSTiTcQGTMcD52lAG9PfiNA2ogCEvDJpJl6MX3PagAAmh21", "cavv": "AAIBBYNoEwAAACcKhAJkdQAAAAA=", "paresStatus": "Y", "xid": "AAIBBYNoEwAAACcKhAJkdQAAAAA=", "directoryServerTransactionId": "2f44602b-ce95-4a7e-9ad1-920e7ace0676", "threeDSServerTransactionId": "4e50f586-b15c-4c03-a186-eafb40d50b80", "specificationVersion": "2.1.0", "acsTransactionId": "3888e153-6b97-4f43-afee-60527c2e0b91" }, "id": "7253538119946872004005", "paymentInformation": { "card": { "bin": "400009", "type": "VISA" } }, "status": "AUTHENTICATION_SUCCESSFUL", "submitTimeUtc": "2024-09-03T08:56:52Z" }