Skip to main content

Cashier appearance customization

When creating an order, pass CSS variables in JSON format via the paymentInfo.cashierAppearance parameter to customize the cashier appearance.
{
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT",
    "cashierAppearance": "{\"--primary-color\":\"#493daa\",\"--font-family\":\"Nunito Sans, sans-serif\"}"
  }
}

Cashier language settings

Use the paymentInfo.cashierLanguage parameter to set the display language of the cashier, in IETF BCP 47 format.
Language codeLanguage
en-HKEnglish (Hong Kong)
zh-Hant-HKTraditional Chinese (Hong Kong)
id-IDIndonesian
ms-MYMalay
tl-PHTagalog
{
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT",
    "cashierLanguage": "en-HK"
  }
}
If the specified language is not supported, error code A0026 will be returned.

Payment method filtering

Use payMethodType and payMethodName to control which payment methods are displayed on the cashier:
{
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT",
    "payMethodType": "CREDITCARD",
    "payMethodName": "CC_VISA"
  }
}
If not specified, the cashier will display all available payment methods. You can also further filter by country via payMethodCountry:
{
  "paymentInfo": {
    "productName": "ONE_TIME_PAYMENT",
    "payMethodCountry": "IDN"
  }
}