跳转到主要内容

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 的金额统一使用 String 类型，不要使用 Number / float / double。 
✅ "100.00"
✅ "0.99"
✅ "10000"     （JPY 等零小数币种）

❌ 100.00      （Number 类型，浮点精度问题）
❌ 100         （Number 类型）
使用 String 而非 Number 是为了避免浮点精度问题。0.1 + 0.2 = 0.30000000000000004 在金融场景中不可接受。

​
金额小数位规则

不同币种对小数位的要求不同。
传错小数位会返回参数错误（A0003）。

​
2 位小数的币种（大部分）

以下币种金额必须精确到 2 位小数： 
"100.00"  ✅
"9.99"    ✅
"100"     ❌（缺少小数位）
"100.0"   ❌（只有 1 位小数）
地区币种
亚太PHP（菲律宾比索）、MYR（马来西亚林吉特）、THB（泰铢）、KHR（柬埔寨瑞尔）、SGD（新加坡元）、HKD（港币）、MOP（澳门元）、CNY（人民币）、AUD（澳元）、MNT（蒙古图格里克）
美洲USD（美元）、BRL（巴西雷亚尔）、MXN（墨西哥比索）、PEN（秘鲁索尔）、CAD（加元）、AWG（阿鲁巴弗罗林）
欧非EUR（欧元）、GBP（英镑）、RUB（俄罗斯卢布）、TRY（土耳其里拉）、PLN（波兰兹罗提）、SEK（瑞典克朗）、NGN（尼日利亚奈拉）
加密USDC、USDT

​
0 位小数的币种（无小数）

以下币种金额不允许有小数点： 
"1000"    ✅
"1000.00" ❌（不允许有小数）
"999.50"  ❌（不允许有小数）
币种名称
JPY日元
KRW韩元
VND越南盾
CLP智利比索

​
特殊币种（同币种 0 位，跨币种 2 位）

以下币种在同币种下单时不允许有小数，但在跨币种下单时允许 2 位小数：
币种名称同币种下单跨币种下单
IDR印尼盾"10000" ✅ / "10000.50" ❌"10000.50" ✅
COP哥伦比亚比索"5000" ✅ / "5000.00" ❌"5000.00" ✅
KES肯尼亚先令"100" ✅ / "100.50" ❌"100.50" ✅
TWD新台币"300" ✅ / "300.00" ❌"300.00" ✅

​
什么是同币种 / 跨币种下单

场景示例说明
同币种商品定价 IDR，用户用 DANA（IDR）支付orderCurrency 与用户支付币种一致
跨币种商品定价 USD，用户用 DANA（IDR）支付orderCurrency 与用户支付币种不同

​
跨币种下单传参

{
  "orderCurrency": "USD",
  "orderAmount": "10.00"
}
跨币种场景下，userCurrency 可不传。但如果 payMethodType 或 payMethodName 未完全指定，需要额外传 payMethodCountry 告诉 Waffo 用户在哪个国家。 Waffo 自动处理汇率换算，用户在收银台看到的是当地货币金额。

​
完整币种列表

币种代码名称小数位备注
IDR印尼盾0 / 2同币种 0 位，跨币种 2 位
USD美元2
PHP菲律宾比索2
BRL巴西雷亚尔2
MXN墨西哥比索2
MYR马来西亚林吉特2
THB泰铢2
CAD加元2
EUR欧元2
AUD澳元2
GBP英镑2
VND越南盾0无小数
CLP智利比索0无小数
COP哥伦比亚比索0 / 2同币种 0 位，跨币种 2 位
PEN秘鲁索尔2
RUB俄罗斯卢布2
KES肯尼亚先令0 / 2同币种 0 位，跨币种 2 位
NGN尼日利亚奈拉2
TWD新台币0 / 2同币种 0 位，跨币种 2 位
HKD港币2
JPY日元0无小数
KRW韩元0无小数
MOP澳门元2
SGD新加坡元2
CNY人民币2
PLN波兰兹罗提2
TRY土耳其里拉2
KHR柬埔寨瑞尔2
SEK瑞典克朗2
AWG阿鲁巴弗罗林2
MNT蒙古图格里克2
USDCUSD Coin2加密货币
USDTTether2加密货币