跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://waffo.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

商户在接入 Waffo 时，需要根据业务模式选择合适的定价币种策略。Waffo 支持三种定价方式。

​
三种定价策略

​
全球统一定价

场景：SaaS 产品、数字内容等，全球统一用一种货币定价（通常为 USD）。 传参方式：
  • orderCurrency: 商户结算币种（如 "USD"）
  • orderAmount: 统一价格（如 "9.99"）
  • userCurrency: 不传，Waffo 自动转换为用户本地币种
优势：定价管理简单，只需维护一套价格体系，汇率由 Waffo 处理。 注意：用户在收银台看到的本地币种金额会因汇率波动而变化。 
{
  "orderCurrency": "USD",
  "orderAmount": "9.99",
  "orderDescription": "Pro Plan - Monthly"
}

​
各国分别定价

场景：电商、游戏等，每个国家有独立的本地币种定价。 传参方式：
  • orderCurrency: 用户所在国的本地币种（如印尼 "IDR"、菲律宾 "PHP"）
  • orderAmount: 该国的本地价格
  • userCurrency: 不传（因为 orderCurrency 就是本地币种，属于同币种下单）
优势：用户看到的金额固定，无汇率波动，体验更好。 注意：需维护各国价格表，且需注意不同币种的小数位规则。详见币种与金额。 印尼（IDR，0 小数位）： 
{
  "orderCurrency": "IDR",
  "orderAmount": "149000",
  "orderDescription": "商品描述"
}
菲律宾（PHP，2 小数位）： 
{
  "orderCurrency": "PHP",
  "orderAmount": "499.00",
  "orderDescription": "商品描述"
}

​
区域定价

场景：按区域分组定价（如东南亚、拉美、欧洲），每个区域使用统一的定价币种。 传参方式：
  • orderCurrency: 区域内的定价币种（如东南亚用 "USD"，欧洲用 "EUR"）
  • orderAmount: 区域统一价格
  • userCurrency: 不传，Waffo 自动转换
优势：平衡定价复杂度和本地化体验，减少需要维护的价格数量。 注意：区域内不同国家的用户看到的本地金额仍会因汇率波动。 
{
  "orderCurrency": "EUR",
  "orderAmount": "8.99",
  "orderDescription": "Pro Plan - Monthly (Europe)"
}

​
传参对比

策略orderCurrencyuserCurrencyorderAmount用户看到的金额
全球统一定价统一币种（如 USD）不传（自动转换）统一价格本地币种等值金额（随汇率变化）
各国分别定价本地币种不传本地价格固定金额
区域定价区域币种不传（自动转换）区域价格本地币种等值金额（随汇率变化）

​
金额格式和小数位

所有金额必须使用 String 类型，不能使用 Number/float/double。
不同币种的小数位规则不同：
类型币种格式
2 位小数USD、PHP、HKD、SGD、EUR 等"9.99"
0 位小数JPY、KRW、VND、CLP"1000"
特殊（同币种 0 位，跨币种 2 位）IDR、COP、KES、TWD同币种："50000"，跨币种："50000.50"
如果小数位不正确，API 会返回错误码 A0003。
完整币种列表和规则详见币种与金额。