---
page_title: Initiate Token Request
product: API Reference
page_source: https://juspay.io/in/docs/api-reference/docs/push-provisioning/initiate-token-request
openapi: https://juspay.io/in/docs/api/swagger?document=https%3A%2F%2Fjuspay.io%2Fin%2Fdocs%2Fapi-reference%2Fdocs%2Fpush-provisioning%2Finitiate-token-request
llms_txt: https://juspay.io/in/docs/llms.txt
product_llms_txt: https://juspay.io/in/docs/api-reference/llms.txt
---

## API Version: default


# Initiate Token Request



Call by Issuer to JuspayAPI initiates the token push request on behalf of cardholder from issuer application into the merchant vaults.Enter API description here...## Endpoints:
- Sandbox: https://sandbox.juspay.in/pushProvision/v1/initiateTokenRequest

- Production: https://api.juspay.in/pushProvision/v1/initiateTokenRequest

## Request Type: 
POST

## Content-Type: 
application/json

## Authorization:

#### Basic Auth:
Auth example
- Value: MUQ2QUZEQzhFQTY0OUU5QTIxQzNFNTQwNkFDMEZCOg==
- Tags: required
## Headers:

#### x-issuer-id:
Issuer id given by juspay
- Tags: String, Mandatory

#### x-issuer-kid:
Issuer key id given by Juspay for JWE, JWS
- Tags: String, Mandatory

#### x-juspay-kid:
Key id given by Juspay to do field level encryption
- Tags: String, Mandatory
## Sample Code Snippets:
### Sample Request:

#### Request Code Snippet:

```request
curl --location 'https://api.juspay.in/pushProvision/v1/initiateTokenRequest' \
--header 'x-issuer-id: <Issuer id given by Juspay>' \
--header 'x-issuer-kid: <Juspay keyid generated during issuer onboarding>' \
--header 'x-juspay-kid: <Issuer keyid generated during issuer onboarding>' \
--header 'Content-Type: application/json' \
--data '{
    "iv": "S0WMVF3I0MCB90-R",
    "tag": "p8y176SdqGNZP_ClOxR1wg",
    "encryptedPayload": "5UAqSRSyJox1ZbMXa38dNaDu3KDy4biSMjUbWoMUiTk-OWO4LJJdKZs29oOVCLyQVGuS8ZdBPEGGB0PmMlBxKJPJFUSMLUByLhghYCQZsRBvA5gGBpriEclzKTWRa7OjH-W7w27WwNkHcdJA47Eph3zDJ2YDrcd8MdXpvemZNW03J4oDAu-TkmDKZoVZdpgQxCRG9KY1fs-weAJreEb3_3TRxkO8-Mo3V8yJfwXXDEA3vpvLIbxJguRNwT8Tic--CRyTYVGu4cyrtFkzFfcgl9WxL0R3hruNa3EtvJPQbJd80fWsbgJjs20PvAwH8EbR4ibLxMDUMxk7waEKgoJZNrjTbc1rBJ_8wYWzpSxQdl6mJikIxqUTl1n8TY0KUfERZcEAENgmt6J9qDqPcos-zVpGr9BGXUja4u8_GGT7guG_xCIY_r_B9n5wZAzrn75YgI2ixMMeU81biw4aubCsEf531vtzrxJXqBE5ifs18OqQoD9TLmITakw7vQK_nRbeHizIIlRfV_I32hncjVXFQ9iN6pRprjAYwkX42HhrBbSiJADQQDOK8k7ye3xESO3lE1G7gbDjKw3ko4eaFh4eh5XQWxmME1bbybi7ItrlC_lXrG3AXRC9KjXU7zDJ-p_-zLV8bAVOo1OlV_LzrGk60gx3pn_gDlIJcMKcxNM5CgPg6O8miIGG8kWAxR1f_OPJp2c27xHA5WAketl05yG9tdmRlOXwwH3pkr9b1EoB59hZR5_a5CZmUz1RxFH_pHZKX9jnX71SeN0Znm_RsWRYYG0Tg4Q90Ag7Qw8luFgON_5JGhuGRZRX6C6CezCnJixZKuEwcRZ9Ze5pYQ0paPwKP0D8D5t_66Wg2IOy8Yq03QvRlURABCVzdcmO8LneOBfkvrM2GXsiiyLDr3H5pO_eliLDtOUDh6PKGt6gHTgg2a6aOi458AYrH03Is_eHCAXQ5TDt1qsFashp7n3VjaqZN-sIOBo0Vtujy9RujxKEhwOzYbj23HxnFZiGvxiuSnN7iVVeXq_oPsN8Pgv4MmTewQdkqqZrounmAIZpvUcjFhjWRQeUtjQ9QTQQLDjnGhPlM9r9uJSsoT-fawoKV4fxCxNpWRI9uI4EF3A717XLp0LHbTn8ay4lLt6NgwbC8RDjhhjQLixtHjyG3AoCO97W5XeXAE4u9mYePLB6TTtmsX-mSHt8f0N_j49XcQ4uJ5T_-2bvg_gdjDAjqG4VhjQf-Fda4l-CKLrreqdaOwJ7TM3GGonwLtwHDLNaApyjf66zvrKohP-o21keSGZjiBI7qcfCPFRWa_avXAZDIhQpt_XdFpvOJd0KtB8aCsITDM4F-tiO4nmzi-gogHQGlbo83QxY8sHMfycQ8cSN8_90bSlrqkJaLK89LrOn0KbTcEg7Nk5AxrKannO_L_3f5LI_2CqlalMMht4Q5YrUQNLZUoweojlgCD43sGKcx4iAgRkK6WmFFtRFqT-O30PKbs-r_KvVGiP8tNRcaBQ9NSRpevih3KeaaDy8OoogebsT30LdpyXAX0FHgWOmQmrCLovYECv3QKOEus_d-BxA3tC4ZIpSDQfiuleaGS2rwm4RMgVmKPaN8K02FjmuTdyc-QnmtcIsdHikwUXqLtxBrGbwiSLApNeKa3bTbsWgZz7-dbmlJmIpSHesRvP-um4O1zHZDS0bLgpqWhrQ8gw1chS9KPLobwUtk25OnwhIrFlsBoseO8zPOCwjdGNvqS5RLCHK_6YULECbsECl2ocR9PodrQc3tKsmb9NZuh6gWiBSmS4e3M_MgvpR02kHv-9kd-zDTSqM7SJTTUTzzCHS-dsj6NFIZg76Xjs71dnvNQ_aIkm_636ehTfbiFSbWVohAkLFjGah-fs-7813rW9SykPlqA5YbbvEO8qYGn87uaOO8XHRRNySCRvu6i-PYMz1E5g5BLJZEd8lJKVN1LpYqcPwLFrohK0uGlwZg--WD73ryNja80GTBLwrXbgFIVRmJK48WbH9Poqq3m2b-RpVfTkToUXC5ho_E8wRx3jEww4voJbBKz-ItBOmodyFk4jGDD0THJoGnClYBAEZfVA8F7_LJ6a71lvQHBL8zBOja0wGsdSby5ayTexnAr6SxDVXbWcCst8Nbvk7LrKCWRY3aoR32Nel0Wm45U3t_rs0GrZ6ItRIUTfTqg4ZHHdg_o0q7BbGaNPXIE-mjd0kQzgQ5wk5KLje1qOMY7hrOdqPDs2uSQ9osmjpaZjvZvOAs-b9Adday1SIPVDFA5K6yQZ4kPSVNVS2n-qTPUi__uVD2TMBl7BeGcJk_s0A_ZKktyGJwpDQDLhwrMJZQsySq8_8P3OgH01M5CFvx1d247MiRt_O_vQdktzApOPzEUFL8TFwPRurfqSIX3f0VB791DID6rgLATGCBTQK_sUhAzVMHFZmfPBBCPA",
    "encryptedKey": "O8gfDVR_g6hj48hHlJVEyD8KiWOE8d470EpYO793k4xcOajd4H-GGyKb0-bshbscqnn8a6yh8B7IaSI7TOjko8sXC8qSDuuqKmO_pVWa1ig5KlQyKYyH3Zh3OXvQoPZdfr566oyH5QpPxmqEkIQrPTwS9pJJnUgbE4gMj30CMEBZxq09GqJmsMKCXMB7LeoaAkOqeUO1_xHUcWtmTQoMXmKWRcbVn3OV9E93-jV9LpW_gqhrH3FtzkrHxavZu4t2Lli6UXWvM29Tdzxxwaevr6JPZ_VuJr5gGbDDc_E3gcFhWV529jFk492VYv0MIFQ7yPDPr9vXsUDvS2EHicAOAk3dcFD483Z0bfWQsRDowD-bI-JwvC0bLAvEH6HFaMFsV_pyF0xB93sO34m-_KSaItoWTIUt9jLvxhcug7Ytu367gdOn2NFhBS_7xbiF6ozwHEp2yFFsA3awPS-bC-k4qklEfcCOYl4iT5UpsQnLjBarTAjGoxGv9_D_LAax4WNh710YotUDhRCL13nE1FpQ7CH_aLwdCYV0Bn5wJ35RKavjE3ejY1gIAOyKi4c64SCvVDG_uFfepdZVqy8s9XvoAPoRgsE0Xn9DEjhLbDBvukAam_HmFPpHBv0sOvGtqoB0HsdjDN1EDn22mPEct_4gb9GB52hvI9DsvxlGsaOvPsg",
    "header": "eyJhbGciOiJSU0EtT0FFUCIsImVuYyI6IkEyNTZHQ00ifQ"
}'

```

### Sample Response:

#### Response:
```json
{
    "requestId": "0asdhf08wgf08sgfasuhf1",
    "merchants": [
        {
            "merchantId": "<Merchant Id>",
            "merchantStatusDesc": "Card already tokenized.",
            "tokenRequestorId": "<Token Requestor ID>",
            "merchantName": "<Merchant Name>",
            "logoUrl": "<Image URL>",
            "merchantStatusCode": "ALREADY_TOKENIZED"
        }
    ]
}

```

## Body Parameters:
### Response:

#### requestId:
- Description: Unique identifier for this request
- Value: value
- Tags: String, Mandatory

#### consentId:
- Description: Id corresponding to consent taken from card holders
- Tags: String, Mandatory

#### encMobileNumber:
- Description: Encrypted Mobile Number of the customer
- Tags: String, Mandatory

#### encCardNumber:
- Description: Encrytped Card Number of the customer
- Tags: String, Mandatory

#### encExpiry:
- Description: Encrypted Expiry date of the card
- Tags: String, Mandatory

#### nameOnCard:
- Description: Encrypted name on card
- Tags: String, Mandatory

#### merchants:
- Description: List of merchants which the customer wants to 
- Tags: String, Mandatory
## API Responses:
### 200:

#### requestId:
- Description: Unique identifier for the request for this response
- Tags: String, Mandatory

#### merchants:
- Description: JSON Object containing the tokenization status at each merchant 
- Tags: String, Mandatory


---

## See Also

- [Get Merchant List](https://juspay.io/in/docs/api-reference/docs/push-provisioning/get-merchant-list)
- [Security Specifications](https://juspay.io/in/docs/api-reference/docs/push-provisioning/security-specifications)