ISO 4217 货币码与金额小数位

报文里的 DE49 放的是数字码不是字母码，而小数位决定了金额怎么读。下面还有个换算器。

两个最容易搞错的地方

第一，DE49 放的是数字码。报文里写的是 392 不是 JPY，是 840 不是 USD。做内部系统映射时把两者搞混，会导致币种识别错误，而这种错误往往要到对账才暴露。

第二，金额是最小货币单位的整数。报文里的 DE4 没有小数点，000000012345 是多少取决于币种：美元是 123.45，日元是 12345，科威特第纳尔是 12.345。

正确的做法

维护一张「币种 → 小数位」的表，所有换算都走这张表，不要让字面量 100 出现在任何金额附近。上面的换算器可以用来核对你的实现算得对不对。

不只是 DE4

DE5（结算金额）、DE6（持卡人入账金额）以及 EMV 的 9F02 标签都遵循同一规则。而且跨境交易里，这三个金额的币种可能各不相同——分别看 DE49、DE50、DE51，别默认它们一致。

真正出事的是小数位

ISO 8583 的金额域不带小数点。那个数字是「最小货币单位」的整数,而多少个最小单位等于一个单位 是由币种决定的,不是由报文决定的。默认到处都是两位小数,你会在两个方向上都出错。

日元的小数位是 0:一笔日元交易里的 000000001000 是 1000 日元,不是 10.00。 科威特第纳尔、巴林第纳尔、约旦第纳尔的小数位是 3:同样这串数字是 1.000 第纳尔。 一个写死的除以 100,会把一千日元的咖啡变成十日元,把一第纳尔的车费变成一千第纳尔 —— 而这两种错在日志里都不像错。

还有两个上面那张表显示不出来的坑。数字码和字母码是独立分配的,所以不能从一个推出另一个, 也不能按一个排序然后指望另一个跟着有序。以及 ISO 4217 里有卡组织压根不支持的码 —— 包括资金码和贵金属码 —— 所以「是合法的 ISO 币种码」和「能路由」不是一回事。 这套算术连带算例在金额与最小货币单位。

相关阅读

• ISO 4217 货币代码完整对照表
• ISO 8583 金额为什么没有小数点
• ISO 8583 常见字段速查
• DE39 响应码查询