pilot

Step 1: Issuer sends a one-time password code {#tms-net-tkn-card-stepup-otp-step1}
==================================================================================

This section describes how to create a one-time password (OTP) for a tokenized card.  
The issuer is notified when the stepUpOptions.method field is set to one of these values:

* `OTP_SMS`
* `OTP_EMAIL`
* `OTP_ONLINE_BANKING`

Endpoint
--------

**Test:** `POST ``https://apitest.cybersource.com``/tms/v2/tokenized-cards/`*{tokenId}*`/authentication-options/one-time-passwords`  
**Production:** `POST ``https://api.cybersource.com``/tms/v2/tokenized-cards/`*{tokenId}*`/authentication-options/one-time-passwords`  
**Production in India:** `POST ``https://api.in.cybersource.com``/tms/v2/tokenized-cards/`*{tokenId}*`/authentication-options/one-time-passwords`  
**Production in Saudi Arabia:** `POST ``https://api.sa.cybersource.com``/tms/v2/tokenized-cards/`*{tokenId}*`/authentication-options/one-time-passwords`{#tms-net-tkn-card-stepup-otp-step1_d49e110}  
**Test in Saudi Arabia:** `POST ``https://apitest.sa.cybersource.com``/tms/v2/tokenized-cards/`*{tokenId}*`/authentication-options/one-time-passwords`{#tms-net-tkn-card-stepup-otp-step1_d49e121}  
The *`{tokenId}`* is the identifier of the tokenized card.

Required Fields for Creating an OTP for Tokenized Card Authentication {#tms-net-tkn-card-stepup-otp-step1-reqfields}
====================================================================================================================

[clientCorrelationId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/client-correlation-id.md "")
:
Set to the client reference ID.

[stepUpOption.id](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/step-up-opt-aa/step-up-opt-id.md "")
:

Related Information
-------------------

* [API Field Reference for the REST API](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/rest/api-fields/rest-api-fields-intro.md "")
  {#tms-net-tkn-card-stepup-otp-step1-reqfields_d117e47}

REST Example: Creating an OTP for Tokenized Card Authentication {#tms-net-tkn-card-stepup-otp-step1-ex-rest}
============================================================================================================

Request

```
{
  "clientCorrelationId": "aB3cD4eF5gH6iJ7kL8mN9oP0qR1sT2uV3wX",
  "stepUpOption": {
    "id": "YWEwMjFhZmFkZDU4ZWI0NDJjYTM0MzY4OTY1YjdhMDE="
  }
}
```

{#tms-net-tkn-card-stepup-otp-step1-ex-rest_d55e24}  
Response to a Successful Request

```
{
  "maxRequestsAllowed": 0,
  "maxVerificationAllowed": 0,
  "codeExpiration": 0
}
```