Skip to main content
When MIOeSIM generates an eSIM activation PDF, it uses the pdfLanguage parameter to determine which language the document is rendered in. The PDF contains the QR code and setup instructions your customer needs to activate their eSIM. Passing the right language code ensures your customer receives instructions they can read without any extra steps on your end.

​
Where to use this parameter

Pass pdfLanguage in the request body of the following endpoints:
  • addEsimOrder — when placing a new eSIM order, include pdfLanguage to generate the activation PDF in the customer’s language.
  • renewCard — when renewing an existing plan, pass pdfLanguage to generate a renewal PDF in the correct language.
  • handlerEsimPdf — when requesting a PDF regeneration for an existing order, pass pdfLanguage to control the output language.

​
Supported languages

No.LanguageCode
1Englishen-US
2中文 (Simplified Chinese)zh-CN
3繁體中文 (Traditional Chinese)zh-TW
4日本語 (Japanese)ja-JP
5Русский язык (Russian)ru-RU
6Español (Spanish)es-ES
7Français (French)fr-FR
8한국어 (Korean)ko-KR
9Deutsch (German)de-DE
10Italiano (Italian)it-IT
11Bahasa Indonesiaid-ID
12اللغة العربية (Arabic)ar-SA
13Português (Portuguese)pt-BR
14Tiếng Việt (Vietnamese)vi-VN
15ภาษาไทย (Thai)th-TH
If you omit pdfLanguage or pass a code that is not in the list above, the PDF defaults to English (en-US).
Pass the pdfLanguage that matches your customer’s locale at checkout. Most platforms store a preferred locale on the user record — use that value directly to look up the matching code in the table above. This removes the need for customers to navigate a foreign-language PDF and reduces activation support requests.