币种与语言

币种精度、金额格式与语言标签

币种与语言 ​

平台没有固定的全局币种或语言列表。每个商户可用的币种以开通结果为准,每个游戏支持的语言以游戏列表为准。

币种 ​

调用 GET /v1/capabilities,currencies 就是当前商户已开通的币种:

json
"currencies": [
  { "code": "USD", "decimal_scale": 2 },
  { "code": "USDT", "decimal_scale": 4 }
]
字段说明
code币种代码,2–16 位大写字母或数字
decimal_scale该币种金额允许的最多小数位数

金额格式 ​

  • 所有金额都是十进制字符串,例如 "100.00",不要使用 JSON 数字或浮点数。
  • 小数位数不能超过 decimal_scale。decimal_scale=2 时,"1.005" 会被拒绝(422 VALIDATION_FAILED),平台不会自动舍入。
  • 小数位数可以少于 decimal_scale,例如 "100"、"100.5" 都合法。
  • 单一钱包回调中,商户返回的 balance 同样不能超过 decimal_scale。
  • 一笔交易只使用一种币种,平台不做换汇。同一玩家的不同币种是不同的钱包。

新增币种需要向平台申请开通。开通前使用该币种会返回 422 CURRENCY_NOT_SUPPORTED。

语言 ​

语言使用 BCP 47 语言标签,例如 en、zh-Hans、zh-Hant-TW、pt-BR。

  • 每个游戏支持的语言见游戏列表中的 languages。
  • 请求进入游戏时用 locale 指定语言,不传默认为 en。请从该游戏的 languages 中选择。
  • 游戏、厂商和分类的多语言名称与图标见 localizations,选择规则见多语言展示。

最后更新于 13小时前