Displaying translated or customized labels

---
tags: [iframe]
---

| Background                                                                                                                                                                                                                                                                                                                                                                                                               |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Before starting this tutorial, make sure you understand the following topics from the [Quick start](doc:quick-start) section:<ul style={{ marginTop: "-5px", marginBottom: "-5px" }}><li>[Sandbox environments](doc:sandbox-environments) (especially about testing).</li><li>[Authentication](doc:authentication) (about authenticating using your API user and when you need a login versus a one-time-use token).</li></ul> |

Nexio provides translations for labels for several languages and locales. You can use those with your site, you can customize those translations, and you can create translations for other languages or locales. 

> 📘 Note
>
> Nexio currently provides translation files for the following languages and regional dialects:
>
> * English (Canada): [https://customerassets.nexiopay.com/CMSLabels\_en\_ca.json](https://customerassets.nexiopay.com/CMSLabels_en_ca.json)
> * English (United States): This is the default and does not need to be specified.
> * French: [https://customerassets.nexiopay.com/CMSLabels\_fr.json](https://customerassets.nexiopay.com/CMSLabels_fr.json)
> * French (Canada): [https://customerassets.nexiopay.com/CMSLabels\_fr\_ca.json](https://customerassets.nexiopay.com/CMSLabels_fr_ca.json)
> * French (United States): [https://customerassets.nexiopay.com/CMSLabels\_fr\_us.json](https://customerassets.nexiopay.com/CMSLabels_fr_us.json) 
> * Japanese: [https://customerassets.nexiopay.com/CMSLabels\_jp.json](https://customerassets.nexiopay.com/CMSLabels_jp.json)
> * Spanish: [https://customerassets.nexiopay.com/CMSLabels\_es.json](https://customerassets.nexiopay.com/CMSLabels_es.json)
> * Spanish (Mexico): [https://customerassets.nexiopay.com/CMSLabels\_es\_mx.json](https://customerassets.nexiopay.com/CMSLabels_es_mx.json)
> * Spanish (United States): [https://customerassets.nexiopay.com/CMSLabels\_es\_us.json](https://customerassets.nexiopay.com/CMSLabels_es_us.json) 
> * Turkish: [https://customerassets.nexiopay.com/CMSLabels\_tr.json](https://customerassets.nexiopay.com/CMSLabels_tr.json)
>
> To customize existing or create new translations, see the [Customizing iframe labels](doc:customizing-iframe-labels) topic.

Regardless of whether you use the standard language files, create your own, or customize an existing one, the steps to display those labels are the same:

1. Identify the label file you want to use and its location.

   For the locations for the standard translations of the labels, see the Note above. 

   For the location for new or changed translations, refer to the information in the [Customizing the iframe labels](doc:customizing-iframe-labels) topic.

2. Send a `POST` request to the [Create one-time-use token](ref:createonetimeusetoken) endpoint.

   * Include the `uiOptions.customTextUrl` parameter in the body of the request and set the value to the URL of the labels file to use for the iframe.

     For example, to use the default Spanish labels, the request looks similar to the following:

     ```shell Example Request for Spanish
     curl -X POST https://api.nexiopaysandbox.com/pay/v3/token \
       -H 'Content-Type: application/json' \
       -H 'Accept: application/json' \
       -H 'Authorization: Basic [Base64_encoded_login]' \
       -d '{
       "uiOptions": {
         "customTextUrl": "https://customerassets.nexiopay.com/CMSLabels_es.json"
       }
     }'
     ```

     <br>

     The response includes a `token` parameter. Encoded within this value is the URL of the labels file. Save this `token` for use in the next step.

     ```json Example 200 Response
     {
       "expiration": "2022-09-18T15:43:05.664Z",
       "fraudUrl": "https://api.nexiopaysandbox.com/pay/v3/fingerprint?token=830d36f6-a5e3-4455-9600-3a55b63e2fc2",
       "token": "830d36f6-a5e3-4455-9600-3a55b63e2fc2"
     }
     ```

     <br>

3. Request the iframe to display on the page using the `token` from the response in **step 2**.

   You may display translated or customized labels for any of the following types of pages:

   * Save payment information page for card - using [Save card token with iframe](ref:savecardtokeniframe)
   * Save payment information page for echeck - using [Save echeck token with iframe](ref:saveechecktokeniframe)
   * Checkout page for card - using [Run card transaction with iframe](ref:runcardtransactioniframe)
   * Checkout page for echeck - using [Run echeck transaction with iframe](ref:runechecktransactioniframe)

   For example, the following request uses the `token` to return the HTML for an iframe for saving payment information for a card (as a token), with the labels from the standard translation file for Spanish (as specified in **step 2**).

   ```shell Example Save Card Iframe Request
   curl -X GET https://api.nexiopaysandbox.com/pay/v3/saveCard?token=830d36f6-a5e3-4455-9600-3a55b63e2fc2