@ducatjs/money 0.0.0 → 0.2.0

package/data/checkout.json

@@ -0,0 +1,230 @@
+{
+  "processor": "Checkout.com",
+  "retrieved": "2026-11-07",
+  "amountFormat": "integer",
+  "sources": {
+    "format": {
+      "url": "https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value",
+      "quotes": [
+        "Additionally, the `amount` value must: Be greater than zero; Not contain decimals; Not contain more than nine digits",
+        "For the following currencies, the `amount` you specify is the final amount, without any additional calculations. For example, the following payment request with `amount` set to `100` is for 100 Japanese Yen",
+        "For the following currencies, the `amount` you specify is divided by 1000 to determine the final amount. For example, the following payment request with `amount` set to `100000` is for 100 Bahraini Dinar.",
+        "The last digit must always be a `0`. For example, an `amount` value of `1001` is invalid.",
+        "For all other currencies, the `amount` you specify is divided by 100 to determine the final amount. For example, the following payment request with `amount` set to `10000` is for 100 US Dollars.",
+        "For payment requests in which the `currency` is `CLP` (Chilean Peso), the last two digits of the `amount` must be `00`. For example, an `amount` value of `100010` is invalid.",
+        "This does not apply to authentication requests sent using the Standalone API."
+      ]
+    },
+    "currencies": {
+      "url": "https://www.checkout.com/docs/developer-resources/codes/currency-codes",
+      "quotes": [
+        "The following table lists the three-letter ISO 4217 code for each of the major currencies we support."
+      ]
+    },
+    "api": {
+      "url": "https://api-reference.checkout.com/v1/swagger.json",
+      "quotes": [
+        "PaymentRequest.amount: {\"maximum\": 9999999999, \"minimum\": 0, \"type\": \"integer\", \"format\": \"int64\"}",
+        "The payment amount. To perform a card verification, do not provide the amount or provide a value of `0`."
+      ]
+    }
+  },
+  "defaultExponent": 2,
+  "exponents": {
+    "BIF": 0,
+    "DJF": 0,
+    "GNF": 0,
+    "ISK": 0,
+    "JPY": 0,
+    "KMF": 0,
+    "KRW": 0,
+    "PYG": 0,
+    "RWF": 0,
+    "UGX": 0,
+    "VUV": 0,
+    "VND": 0,
+    "XAF": 0,
+    "XOF": 0,
+    "XPF": 0,
+    "BHD": 3,
+    "IQD": 3,
+    "JOD": 3,
+    "KWD": 3,
+    "LYD": 3,
+    "OMR": 3,
+    "TND": 3
+  },
+  "multiples": {
+    "BHD": 10,
+    "IQD": 10,
+    "JOD": 10,
+    "KWD": 10,
+    "LYD": 10,
+    "OMR": 10,
+    "TND": 10,
+    "CLP": 100
+  },
+  "standaloneMultiples": {
+    "CLP": 1
+  },
+  "currencies": [
+    "AED",
+    "AFN",
+    "ALL",
+    "AMD",
+    "AOA",
+    "AUD",
+    "AWG",
+    "AZN",
+    "BAM",
+    "BBD",
+    "BDT",
+    "BHD",
+    "BIF",
+    "BMD",
+    "BND",
+    "BOB",
+    "BRL",
+    "BSD",
+    "BTN",
+    "BWP",
+    "BZD",
+    "CAD",
+    "CDF",
+    "CHF",
+    "CLP",
+    "CNY",
+    "COP",
+    "CRC",
+    "CUP",
+    "CVE",
+    "CZK",
+    "DJF",
+    "DKK",
+    "DOP",
+    "DZD",
+    "EGP",
+    "ERN",
+    "ETB",
+    "EUR",
+    "FJD",
+    "FKP",
+    "GBP",
+    "GEL",
+    "GIP",
+    "GNF",
+    "GTQ",
+    "GYD",
+    "HKD",
+    "HNL",
+    "HTG",
+    "HUF",
+    "IDR",
+    "ILS",
+    "INR",
+    "IQD",
+    "IRR",
+    "ISK",
+    "JMD",
+    "JOD",
+    "JPY",
+    "KES",
+    "KGS",
+    "KHR",
+    "KMF",
+    "KRW",
+    "KWD",
+    "KYD",
+    "KZT",
+    "LAK",
+    "LKR",
+    "LRD",
+    "LSL",
+    "LYD",
+    "MAD",
+    "MDL",
+    "MGA",
+    "MKD",
+    "MMK",
+    "MNT",
+    "MOP",
+    "MRU",
+    "MUR",
+    "MVR",
+    "MWK",
+    "MXN",
+    "MYR",
+    "MZN",
+    "NAD",
+    "NGN",
+    "NIO",
+    "NOK",
+    "NPR",
+    "NZD",
+    "OMR",
+    "PAB",
+    "PEN",
+    "PGK",
+    "PHP",
+    "PKR",
+    "PLN",
+    "PYG",
+    "QAR",
+    "RON",
+    "RSD",
+    "RWF",
+    "SAR",
+    "SBD",
+    "SCR",
+    "SEK",
+    "SGD",
+    "SHP",
+    "SLE",
+    "SLL",
+    "SOS",
+    "SRD",
+    "STN",
+    "SVC",
+    "SZL",
+    "THB",
+    "TJS",
+    "TMT",
+    "TND",
+    "TOP",
+    "TRY",
+    "TTD",
+    "TWD",
+    "TZS",
+    "UAH",
+    "UGX",
+    "USD",
+    "UYU",
+    "UZS",
+    "VES",
+    "VND",
+    "VUV",
+    "WST",
+    "XAF",
+    "XCD",
+    "XCG",
+    "XDR",
+    "XOF",
+    "XPF",
+    "YER",
+    "ZAR",
+    "ZMW"
+  ],
+  "notes": [
+    "CLP is not in the full-amount list, so it falls under \"all other currencies\": two decimals, with the last two digits 00 for payments (like Stripe's ISK). ISO 4217 and Stripe give CLP 0 decimals; Adyen gives it 2 without the 00 rule.",
+    "Three-decimal currencies include IQD and LYD (Stripe lists neither); all seven need the last digit 0.",
+    "UYI (ISO 0 decimals) is not on the currency-codes page. MGA follows ISO (2), unlike Stripe (0).",
+    "The currency-codes page lists SLL (withdrawn from ISO 4217) and XDR (ISO minor unit N.A.); both fall under \"all other currencies\" (2). It does not list CLF, UYW, UYI, VED or ZWG.",
+    "Limits disagree: the format page says greater than zero and at most nine digits; the API reference allows 0 (card verification) up to 9999999999 (ten digits). Neither limit is enforced by ducat."
+  ],
+  "unverified": [
+    {
+      "claim": "The currency-codes page is the complete list of accepted presentment currencies (it says \"major currencies\").",
+      "verified": false
+    }
+  ]
+}

package/data/cldr-cash.json

@@ -0,0 +1,101 @@
+{
+  "source": "https://raw.githubusercontent.com/unicode-org/cldr/release-49/common/supplemental/supplementalData.xml",
+  "note": "CLDR <currencyData> fractions with a cash rule. cashDigits is the number of decimals cash amounts show, and cashRounding (0 means 1) the step in units of the last of them: CHF cashDigits 2, cashRounding 5 is CHF 0.05.",
+  "currencies": {
+    "AMD": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "CAD": {
+      "digits": 2,
+      "cashDigits": 2,
+      "cashRounding": 5
+    },
+    "CHF": {
+      "digits": 2,
+      "cashDigits": 2,
+      "cashRounding": 5
+    },
+    "CRC": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "CZK": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "DKK": {
+      "digits": 2,
+      "cashDigits": 2,
+      "cashRounding": 50
+    },
+    "GYD": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "HUF": {
+      "digits": 0,
+      "cashDigits": 0,
+      "cashRounding": 5
+    },
+    "MNT": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "MRU": {
+      "digits": 2,
+      "cashDigits": 2,
+      "cashRounding": 20
+    },
+    "MUR": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "NOK": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "PKR": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "RSD": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "SEK": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "TWD": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "TZS": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "UZS": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    },
+    "VEF": {
+      "digits": 2,
+      "cashDigits": 0,
+      "cashRounding": 0
+    }
+  }
+}

package/data/historic.json

@@ -0,0 +1,78 @@
+{
+  "description": "Withdrawn ISO 4217 codes and non-ISO codes for @ducatjs/money/historic. Codes, names and withdrawal dates come from ISO 4217 List Three (data/iso4217-list-three.xml). List Three has no minor units, so each exponent here is the one ISO 4217 gave the code while it was current. Only codes whose exponent is sourced are included.",
+  "sources": {
+    "listThree": {
+      "url": "https://www.six-group.com/dam/download/financial-information/data-center/iso-currrency/lists/list-three.xml",
+      "published": "2026-01-01",
+      "retrieved": "2026-11-08"
+    },
+    "exponents": {
+      "url": "https://github.com/openjdk/jdk/blob/master/src/java.base/share/data/currency/CurrencyData.properties",
+      "note": "OpenJDK's currency data (dataVersion 180) keeps the ISO 4217 minor units of withdrawn codes; codes it lists as minorUndefined (XFO, XFU) are not monetary and are left out",
+      "retrieved": "2026-11-08"
+    }
+  },
+  "exponents": {
+    "ADP": 0,
+    "AFA": 2,
+    "ANG": 2,
+    "ATS": 2,
+    "AYM": 2,
+    "AZM": 2,
+    "BEF": 0,
+    "BGL": 2,
+    "BGN": 2,
+    "BYB": 0,
+    "BYR": 0,
+    "CSD": 2,
+    "CUC": 2,
+    "CYP": 2,
+    "DEM": 2,
+    "EEK": 2,
+    "ESP": 0,
+    "FIM": 2,
+    "FRF": 2,
+    "GHC": 2,
+    "GRD": 0,
+    "GWP": 2,
+    "HRK": 2,
+    "IEP": 2,
+    "ITL": 0,
+    "LTL": 2,
+    "LUF": 0,
+    "LVL": 2,
+    "MGF": 0,
+    "MRO": 2,
+    "MTL": 2,
+    "MZM": 2,
+    "NLG": 2,
+    "PTE": 0,
+    "ROL": 0,
+    "RUR": 2,
+    "SDD": 2,
+    "SIT": 2,
+    "SKK": 2,
+    "SLL": 2,
+    "SRG": 2,
+    "STD": 2,
+    "TMM": 2,
+    "TPE": 0,
+    "TRL": 0,
+    "USS": 2,
+    "VEB": 2,
+    "VEF": 2,
+    "YUM": 2,
+    "ZMK": 2,
+    "ZWD": 2,
+    "ZWL": 2,
+    "ZWN": 2,
+    "ZWR": 2
+  },
+  "nonIso": {
+    "CNH": {
+      "name": "Chinese Yuan Renminbi (offshore)",
+      "exponent": 2,
+      "note": "the offshore renminbi traded in Hong Kong; not an ISO 4217 code, listed by Adyen"
+    }
+  }
+}