收单货币 amount 参数说明
在调用收单接口时，所有的 amount 金额参数应以 最小单位（minor unit）表示为自然数。
✅ 通用说明
amount参数必须为整数类型。- 精度指的是该币种允许的小数位数：
- 精度为
0：不带小数 - 精度为
2：保留 2 位小数后 * 100 - 精度为
3：保留 3 位小数后 * 1000 - 精度为
4：保留 4 位小数后 * 10000
- 精度为
示例
| 币种 | 金额 | amount 值（整数） | 精度说明 |
|---|---|---|---|
| USD | 1.00 | 100 | 精度 2 |
| JPY | 1 | 1 | 精度 0 |
| KWD | 1.234 | 1234 | 精度 3 |
| CLF | 0.1234 | 1234 | 精度 4 |
🟢 精度为 0 的币种（无小数）
以下币种的金额不带任何小数位，直接用最小单位表示。
BIF, CLP, DJF, GNF, ISK, JPY, KMF, KRW, PYG, RWF, UGX, UYI, VND, VUV, XAF, XOF, XPF示例
| 币种 | 金额 | amount |
|---|---|---|
| JPY | ¥1 | 1 |
| KRW | ₩1 | 1 |
| VND | ₫1 | 1 |
| XOF | 1 | 1 |
🟡 精度为 3 的币种（三位小数）
这些币种必须乘以 1000 进行整数化。
BHD, IQD, JOD, KWD, LYD, OMR, TND示例
| 币种 | 金额 | amount |
|---|---|---|
| KWD | 1.234 | 1234 |
| BHD | 0.505 | 505 |
🔵 精度为 4 的币种（四位小数）
CLF, UYW示例
| 币种 | 金额 | amount |
|---|---|---|
| CLF | 0.1234 | 1234 |
⚪ 默认精度为 2 的币种
未在上述列表中的币种，默认使用两位小数。
示例
| 币种 | 金额 | amount |
|---|---|---|
| USD | 1.00 | 100 |
| EUR | 15.99 | 1599 |
| NGN | 100.50 | 10050 |
📝 接口使用建议
如需更详细的国际币种与精度映射，可参考 ISO 4217 标准
Updated 1 day ago