On This Page

Create Tokenized Card Authentication Registration

This section describes how to create a Passkey Service registration for a device and network token combination. You can use the information from the

authenticatedIdentities

field object to send an optional request to the

payment-credentials

API.

Before you send this request, you must receive the

AUTHENTICATION_REGISTRATION

value in the

action

field from the create tokenized card authentication options
or validate a one-time password or issuer authentication code
request. For more information see Create Tokenized Card Authentication Options and Validate a One-Time Password or Issuer Authentication Code.

Endpoint

Test:

POST https://apitest.cybersource.com/tms/v2/tokenized-cards/{tokenId}
/authentication-registrations

Production:

POST https://api.cybersource.com/tms/v2/tokenized-cards/{tokenId}
/authentication-registrations

Production in India:

POST https://api.in.cybersource.com/tms/v2/tokenized-cards/{tokenId}
authentication-registrations

The {tokenId}
is the identifier of the tokenized card.

Required Fields for Creating Tokenized Card Authentication Registration

authenticatorRenderMethod
buyerInformation.language
clientCorrelationId
deviceInformation.httpAcceptContent
deviceInformation.httpBrowserColorDepth
deviceInformation.httpBrowserJavaEnabled
deviceInformation.httpBrowserJavaScriptEnabled
deviceInformation.httpBrowserLanguage
deviceInformation.httpBrowserScreenHeight
deviceInformation.httpBrowserScreenWidth
deviceInformation.httpBrowserTimeDifference
deviceInformation.ipAddress
deviceInformation.platformType
deviceInformation.userAgentBrowserValue
merchantInformation.merchantDescriptor.name
merchantInformation.merchantDescriptor.url
orderInformation.amountDetails.currency
orderInformation.amountDetails.totalAmount
orderInformation.billTo.email
sessionInformation.secureToken

Related Information

API Field Reference for the REST API

Optional Fields for Creating Tokenized Card Authentication Registration

orderInformation.billTo.phoneNumber

Related Information

API Field Reference for the REST API

REST Example: Creating Tokenized Card Authentication Registration

Request

{
  "clientCorrelationId": "4cba8c5a-5b21-4812-8783-f91be68aa72a",
  "sessionInformation": {
    "secureToken": "ezAwMX06AAM1NUHl3Gq8..."
  },
  "authenticatorRenderMethod": "IFRAME",
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "1765.95",
      "currency": "978"
    },
    "billTo": {
      "email": "[email protected]",
      "phoneNumber": "4158880000"
    }
  },
  "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"
  },
  "buyerInformation": {
    "language": "en_US"
  }
}

Response to a Successful Request

{
  "authenticationContext": {
    "id": "de5ecf36-2a5c-4f66-b01f-15d6e5b73715",
    "endpoint": "/vts-auth/authenticate",
    "payload": "aGVsbG8",
    "platformType": "WEB"
  }
}