多語言收銀台：如何讓買家用自己的語言看到收銀台、收據和郵件

多語言收銀台會用買家自己的語言顯示付款頁面，包括文字、操作説明和錯誤提示，而不是商戶的語言。對跨境銷售來説，這是成本最低的改進之一：看不懂自己的卡為什麼被拒、也看不懂下一個按鈕是做什麼的買家，只會直接離開。

這篇文章説明如何在 KukoPay 上讓買家看到自己語言的收銀台、收據和收據郵件如何跟隨、為什麼語言從不根據瀏覽器猜測，以及除了文字之外，收銀台還需要哪些本地化才能讓買家覺得親切。

收銀台支持哪些語言？

託管收銀台支持英文、中文、日文、韓文和德文（en、zh、ja、ko、de）。買家看到的所有內容都已翻譯：頁面、支付表單，以及出錯時的提示，比如卡被拒、安全碼錯誤、鏈接過期。（目前有一個例外：韓文頁面上的銀行卡輸入欄仍是英文。）

如何選擇收銀台語言

語言按以下順序決定：

1. 地址上的 locale：在 checkout_url 後追加 &locale=ja，或在收款鏈接後追加 ?locale=ja；
2. 訂單的 locale：下單時傳 "locale": "zh" 或 "en"；
3. 都沒有時為英文。

curl -X POST "https://api.kukopay.com/v1/orders" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $KUKOPAY_API_KEY" \
  -d '{
    "amount": 26800,
    "currency": "CNY",
    "subject": "年度會員",
    "locale": "zh",
    "receipt_email": "[email protected]"
  }'

訂單的 locale 只接受 zh 或 en；日文、韓文或德文，請在你重定向的收銀台地址後追加 &locale=。

為什麼不直接跟隨瀏覽器語言？

收銀台刻意不使用瀏覽器的語言。一位中國買家的辦公電腦瀏覽器可能設置成英文，一個被轉發的鏈接也可能被別人打開，結果都會顯示錯誤的語言，而且同一個鏈接在不同人面前看起來也不一樣。你比買家的瀏覽器更了解你的買家：根據你網站的語言設置或買家的賬戶選擇語言，並明確傳過來。這樣同一個鏈接永遠顯示一致。

多語言的收款鏈接

收款鏈接使用同樣的參數：https://checkout.kukopay.com/pay/plink_7c2a41e9d8b30f56?locale=ja。給每個受眾發各自的版本，比如一份郵件發日文版、另一份發中文版，訂單和計數仍然歸在同一個鏈接下。控制台的收款鏈接頁面可以在複製前選擇語言。見 收款鏈接是什麼。

收據和收據郵件跟隨買家

如果收據用的是另一種語言，多語言收銀台就前功盡棄了。在 KukoPay：

• 訂單帶有 locale 時，收據頁面和收據郵件使用它；
• 沒有時，使用買家在收銀台上實際看到的語言；
• 沒有經過收銀台的訂單，使用英文；
• 在收據鏈接後追加 &locale=，可以用五種語言中的任意一種查看。

因為這些都不讀取瀏覽器語言，所以收據頁面和收據郵件永遠不會不一致。如何發送收據，見 付款收據和發票有什麼區別。

本地化不只是翻譯文字

語言只是本地化收銀台的一部分，其他部分同樣重要：

• 幣種。 儘量用買家習慣的幣種標價，在 KukoPay 上可以是 USD、HKD 或 CNY。每個幣種是獨立的餘額，平台不做自動換匯，所以買家看到的價格就是實際扣款金額。見 網站如何接收國際付款。
• 支付方式。 只有國際信用卡的中文收銀台，仍然會流失中國大陸的買家；請同時提供支付寶和微信支付，見 海外商戶如何接入支付寶和微信支付收款。
• 你的名稱。 買家認得的是你的品牌，而不是你的法律主體。在 商戶名稱與品牌 中設置收銀台上顯示的對外名稱和 Logo，見 託管收銀台是什麼。
• 回跳。 把語言放進你的 return_url，讓買家回到他開始時使用的語言頁面。

哪些內容保持單一語言

有些內容按設計不做翻譯：

• 訂單本身的數據：你傳入的 subject 會按原樣顯示，如果需要，請用買家的語言來寫；
• 返回給你服務器的接口錯誤信息，它跟隨請求的語言設置，而不是買家的語言；做分支時請用錯誤碼，而不是文案（見 支付接口錯誤處理）；
• 控制台的文字，它跟隨每位團隊成員自己選擇的語言。

總結

• 多語言收銀台用每位買家自己的語言顯示付款頁面、提示信息和收據；
• KukoPay 的收銀台支持英文、中文、日文、韓文和德文，依次按地址上的 &locale=、訂單的 locale、英文來決定；
• 從不使用瀏覽器語言，所以同一個鏈接永遠顯示一致；
• 收款鏈接支持 ?locale=，一個鏈接可以用多種語言分享；
• 收據和收據郵件跟隨訂單的語言，或者買家在收銀台上看到的語言；
• 把語言和合適的幣種、本地支付方式以及買家認得的名稱搭配起來。