On This Page
FILTER BY TAG

Create Tokenized Card Authentication Options

This section describes how to determine what Passkey Service authentication options are available for a tokenized card.

Passkey Service Authentication Response Indicators

After you send this request, the response includes one of these indicators in the
action
 field. These are the possible values that indicate the Passkey Service authentication status:
  • AUTHENTICATE
    : The device and network token combination is registered with Passkey Service.
  • STEP_UP_AUTHENTICATE
    : The device and network token combination is not registered with Passkey Service and the issuer has challenged the device binding.
  • AUTHENTICATION_REGISTRATION
    : The device and network token combination is not registered with Passkey Service and the issuer has approved the device binding.

Endpoint

Test:
POST
https://apitest.cybersource.com
/tms/v2/tokenized-cards/
{tokenId}
/authentication-options
Production:
POST
https://api.cybersource.com
/tms/v2/tokenized-cards/
{tokenId}
/authentication-options
Production in India:
POST
https://api.in.cybersource.com
/tms/v2/tokenized-cards/
{tokenId}
/authentication-options
Production in Saudi Arabia:
POST
https://api.sa.cybersource.com
/tms/v2/tokenized-cards/
{tokenId}
/authentication-options
Test in Saudi Arabia:
POST
https://apitest.sa.cybersource.com
/tms/v2/tokenized-cards/
{tokenId}
/authentication-options
The
{tokenId}
 is the identifier of the tokenized card.

REST Example: Creating Tokenized Card Authentication Options

Request
{
                        "clientCorrelationId": "4cba8c5a-5b21-4812-8783-f91be68aa72a",
                        "sessionInformation": {
                        "secureToken": "ezAwMX06AAM1NUHl3Gq8..."
                        },
                        "authenticatorRenderMethod": "IFRAME",
                        "orderInformation": {
                        "amountDetails": {
                        "totalAmount": "1765.95",
                        "currency": "978"
                        }
                        },
                        "merchantInformation": {
                        "merchantDescriptor": {
                        "name": "TWVyY2hhbnQgVlphRjVYQmo",
                        "url": "aHR0cHM6Ly93d3cuTWVyY2hhbnQtVlphRjVYQmouY29t"
                        }
                        },
                        "deviceInformation": {
                        "platformType": "WEB",
                        "ipAddress": "104.28.3.217",
                        "httpAcceptContent": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
                        "httpBrowserLanguage": "en-US",
                        "httpBrowserJavaEnabled": false,
                        "httpBrowserJavaScriptEnabled": true,
                        "httpBrowserColorDepth": "24",
                        "httpBrowserScreenHeight": "1080",
                        "httpBrowserScreenWidth": "1920",
                        "httpBrowserTimeDifference": "420",
                        "userAgentBrowserValue": "Mozilla/5.0(WindowsNT10.0;Win64;x64)AppleWebKit/537.36(KHTML,likeGecko)Chrome/134.0.0.0Safari/537.36Edg/134.0.0.0"
                        }
                        }
Response to a Successful Request
{
                        "action": "AUTHENTICATE",
                        "authenticationContext": {
                        "id": "de5ecf36-2a5c-4f66-b01f-15d6e5b73715",
                        "endpoint": "/vts-auth/authenticate",
                        "payload": "aGVsbG8",
                        "platformType": "WEB"
                        }
                        }
Response to a Successful Request
{
                        "action": "STEP_UP_AUTHENTICATE",
                        "stepUpOptions": [
                        {
                        "method": "OTP_SMS",
                        "value": "415****000",
                        "source": "1-800-847-291",
                        "id": "YWEwMjFhZmFkZDU4ZWI0NDJjYTM0MzY4OTY1YjdhMDE="
                        },
                        {
                        "method": "OTP_EMAIL",
                        "value": ip****@email.com,
                        "source": email@issuer.com,
                        "id": "ZTk1OGUyODM4ZjAzN2MzMmQzZGMyMjZjNGQwZTcyMDE="
                        },
                        {
                        "method": "OTP_ONLINE_BANKING",
                        "value": "Mobile Banking",
                        "source": "br.com.bradesco.next|a2a",
                        "id": "NzNkOWI0ZTVjNzA3MzA4OGQ4YmFjYjYwMDg0ZjRjMDE="
                        },
                        {
                        "method": "APP_TO_APP",
                        "value": "Verify with Bank",
                        "source": https://usa.visa.com/app/af801b935f19ae03a718d40,
                        "id": "MGZlY2YwOWQ3MDZmYWZjZGMwN2Y0YjllZWFkODZkMDI=",
                        "requestPayload": "cDkwMjFhZmFkZDVmZ2hqMzQyY2EzNTM2ODk2NWI3YTAy"
                        },
                        {
                        "method": "APP_TO_APP",
                        "value": "Verify with Bank",
                        "source": https://usa.visa.com/app/af801b935f19ae03a718d40,
                        "id": "ZWY2NTkyZDFiNjZlZTMwZGQyNjg1ZDY3NDY0YTc1MDE=",
                        "requestPayload": "cDkwMjFhZmFkZDVmZ2hqMzQyY2EzNTM2ODk2NWI3YTAy",
                        "platformType": "WEB",
                        "subMethod": "3DS"
                        },
                        {
                        "method": "CUSTOMER_SERVICE",
                        "value": "1-800-847-2911",
                        "id": "ODk3Zjk1ODhhMzI1YTllOTY1ZGU0NjhhMDY4OGE3MDE="
                        },
                        {
                        "method": "OUTBOUND_CALL",
                        "value": "415****000",
                        "id": "YmIwMjFhZmFkZDU5ZWI0NDJjYTM1MzY4OTY1YjdhMDI="
                        }
                        ]
                        }
Response to a Successful Request
{
                        "action": "AUTHENTICATION_REGISTRATION"
                        }
RELATED TO THIS PAGE