Upload custom translation files

POST/

ImportantBefore uploading your translation files using the /translations endpoint, ensure that they are linguistically accurate and representative of the user experience.

Use this endpoint to upload custom translation files for a specific program. This endpoint allows you to customize the values for the keys contained in the translations object so that they will appear in the target language in the customer-facing UI. UX Toolkit uses key and value pairs to render the translations used in web components. Each key is an identifier used to reference a specific piece of content in a web component, while the value is the translated text string that replaces that key on the customer-facing UI. See the sample request body that follows for an example. For a full list of keys, contact your Marqeta onboarding specialist. See also the Using custom translation files section in the UX Toolkit Getting Started guide.

Request body

Fields	Description
program_short_code string Required	Program short code on the Marqeta platform. Allowable Values: Existing program short code
language_code string Required	Language code associated to translations. Allowable Values: `bg-BG`, `ca-ES`, `cs-CZ`, `de-DE`, `el-GR`, `en-GB`, `en-US`, `es-ES`, `et-EE`, `fi-FI`, `fr-CA`, `fr-FR`, `hr-HR`, `hu-HU`, `it-IT`, `lt-LT`, `lv-LV`, `nl-NL`, `pl-PL`, `pt-BR`, `pt-PT`, `ro-RO`, `ru-RU`, `sk-SK`, `sl-SI`, `sv-SE`
translations object Required	Object that contains a list of key/value pairs for translations. For a full list of keys, contact your Marqeta onboarding specialist. Allowable Values: Valid JSON object

Sample request body

JSON

{
  "program_short_code": "mqtest",
  "language_code": "es-ES",
  "translations": {
      "translation": {
          "activate_card": "Activar tu tarjeta",
          "replace_card": "Reemplazar tu tarjeta"
      }
  }
}

Sample response body

The only response for a call made to the /translations endpoint is 201 Successfully uploaded a translation.

JSON

HTTP response code 201

For the full list of codes supported by the Marqeta platform, see HTTP response codes

Getting Started

Testing

Card Issuing

Card Processing

Accounts & Money Movement

Risk, Fraud, and Disputes

Cardholder User Experience

Upload custom translation files

Request body

Sample request body

Sample response body

​Request body

​Sample request body

​Sample response body

Request body

Sample request body

Sample response body