{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/white-label/deep-link/customer-data/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Customer data

\n

You can include customer info in a deep link to help pre-fill fields required at payment.

\n

When providing sensitive customer info, you must take steps to encrypt their data. Partners wishing to submit customer data through deep links will receive an encryption key.

\n

Parameters

\n

The following customer parameters are accepted:

\n\n

Encryption process

\n

To properly encrypt customer data, take the following steps:

\n
    \n
  1. \nSerialize the object.\n
    2. \n
  2. \nEncrypt the serialized object using the \nCTR-AES256 encryption algorithm\n and provided encryption key.\n
    3. \n
  3. \nURL encode the encrypted result.\n
    4. \n
  4. \nAdd the result to the query using the \nmsmCrypt\n parameter. We strongly recommend using this parameter with a \ndestination parameter\n.\n
    5. \n
\n

When the user reaches the payment page on the white label platform, their information will already be filled in:

\n

\n \n \n

\n

JavaScript libraries

\n

We have developed a universal library for our partners which can be used with NodeJS or a basic JavaScript client.

\n

We have also set up a full example which uses our library and builds a valid URL.

\n

PHP class

\n

We provide a PHP class for our partners which can be used to encrypt customer data:

\n
\n
jsonSerialize());\n\n\t\tredocly_dollar_signkey = redocly_dollar_signthis->base64url_decode(self::AES_KEY);\n\n\t\tredocly_dollar_signiv = str_repeat("\\\\0", 16);\n\n\t\tredocly_dollar_signencrypted = openssl_encrypt(redocly_dollar_signplainText, 'aes-256-ctr', redocly_dollar_signkey, OPENSSL_RAW_DATA, redocly_dollar_signiv);\n\n\t\tredocly_dollar_signencrypted = utf8_encode(redocly_dollar_signencrypted);\n\n\t\treturn redocly_dollar_signthis->encodeUriComponent(redocly_dollar_signencrypted);\n\t}\n\n\tprivate function base64url_decode(string redocly_dollar_signdata): string\n\t{\n\t\treturn base64_decode(str_pad(strtr(redocly_dollar_signdata, '-_', '+/'), strlen(redocly_dollar_signdata) % 4, '=', STR_PAD_RIGHT));\n\t}\n\n\t/**\n\t* see http://www.rither.de/a/informatik/php-beispiele/strings/urls-encodieren-und-decodieren/\n\t*\n\t* @param string redocly_dollar_signstr\n\t*\n\t* @return string\n\t*/\n\tprivate function encodeUriComponent(string redocly_dollar_signstr): string\n\t{\n\t\tredocly_dollar_signsearch = ['%21', '%2A', '%28', '%29', '%27', '%7E', '%uFFFD'];\n\n\t\tredocly_dollar_signreplace = ['!', '*', '(', ')', '\\\\'', '~', '%EF%BF%BD'];\n\n\t\tredocly_dollar_signsubject = rawurlencode(redocly_dollar_signstr);\n\n\t\treturn str_replace(redocly_dollar_signsearch, redocly_dollar_signreplace, redocly_dollar_signsubject);\n\t}\n}`, `13232525093113502000`)\"\n >\n
Copy
\n
Copied
\n
\n 
class GoTuiDeepLinkDataEncrypter\n{\n\tconst AES_KEY = 'LI2wmCDSR-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';\n\n\t/**\n\t* TUI DX Data Sharing Specification 26.3.2022\n\t* 1. Serialize the object\n\t* 2. Encrypt the result using the AES-CTR 256 encrypt algorithm\n\t*\n\t* @param JsonSerializable $deeplinkData\n\t*\n\t*/\n\n\tpublic function encrypt(JsonSerializable $deeplinkData): string\n\t{\n\t\t$plainText = json_encode($deeplinkData->jsonSerialize());\n\n\t\t$key = $this->base64url_decode(self::AES_KEY);\n\n\t\t$iv = str_repeat(\"\\0\", 16);\n\n\t\t$encrypted = openssl_encrypt($plainText, 'aes-256-ctr', $key, OPENSSL_RAW_DATA, $iv);\n\n\t\t$encrypted = utf8_encode($encrypted);\n\n\t\treturn $this->encodeUriComponent($encrypted);\n\t}\n\n\tprivate function base64url_decode(string $data): string\n\t{\n\t\treturn base64_decode(str_pad(strtr($data, '-_', '+/'), strlen($data) % 4, '=', STR_PAD_RIGHT));\n\t}\n\n\t/**\n\t* see http://www.rither.de/a/informatik/php-beispiele/strings/urls-encodieren-und-decodieren/\n\t*\n\t* @param string $str\n\t*\n\t* @return string\n\t*/\n\tprivate function encodeUriComponent(string $str): string\n\t{\n\t\t$search = ['%21', '%2A', '%28', '%29', '%27', '%7E', '%uFFFD'];\n\n\t\t$replace = ['!', '*', '(', ')', '\\'', '~', '%EF%BF%BD'];\n\n\t\t$subject = rawurlencode($str);\n\n\t\treturn str_replace($search, $replace, $subject);\n\t}\n}
\n
","headings":[{"value":"Customer data","depth":1},{"value":"Parameters","depth":2},{"value":"Encryption process","depth":2},{"value":"JavaScript libraries","depth":2},{"value":"PHP class","depth":2}]},"contentItem":{"data":{"lastModified":"2025-12-18T16:31:42.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"6756c1ee-aa8e-55cd-87e0-b5fdc887e4e8__redocly content/white-label/deep-link/customer-data/","seo":{"title":"Customer data","description":"Learn how to securely send sensitive customer data for Musement's white label solution.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"white-label/deep-link/customer-data.md","pageBaseUrl":"/white-label/deep-link/customer-data","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"Customer data","id":"customer-data"},{"depth":2,"value":"Parameters","id":"parameters"},{"depth":2,"value":"Encryption process","id":"encryption-process"},{"depth":2,"value":"JavaScript libraries","id":"javascript-libraries"},{"depth":2,"value":"PHP class","id":"php-class"}]},"data":{"title":"","seo":{"description":"Learn how to securely send sensitive customer data for Musement's white label solution."}},"catalogInfo":null,"link":"/white-label/deep-link/customer-data/","sidebarName":"__alternative-sidebar__-data-24763-white-label-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}