ISO 4217 PHP Library

Installs: 8 293 028

Dependents: 4

Suggesters: 0

Security: 0

Stars: 159

Watchers: 6

Forks: 20

1.0.2 2022-02-27 10:14 UTC

This package is auto-updated.

Last update: 2024-05-27 15:21:10 UTC


A PHP library providing ISO 4217 data. This is a fork of alcohol/iso4217 and here's why I did the fork.

Build Status License

What is ISO 4217

ISO 4217 is a standard published by the International Organization for Standardization, which delineates currency designators, country codes (alpha and numeric), and references to minor units in three tables.

-- Wikipedia


Either install directly from command line using composer:

$ composer require "payum/iso4217:~1.0"




$iso4217 = new \Payum\ISO4217\ISO4217; 

$euro = $iso4217->findByAlpha3('EUR');

// or

$euro = $iso4217->findByNumeric('978');

$euro->getName();    // Euro
$euro->getAlpha3();  // EUR
$euro->getNumeric(); // 978
$euro->getExp();     // 2
$euro->getCountry(); // ['AD', 'AT' ... 'YT', 'ZW']

// same instance
$iso4217->findByAlpha3('EUR') === $iso4217->findByAlpha3('EUR'); // true
$iso4217->findByAlpha3('EUR') === $iso4217->findByAlpha3('USD'); // false


The following codes have been intentionally left out:

  • BOV Bolivian Mvdol (funds code)
  • CHE WIR Euro (complementary currency)
  • CHW WIR Franc (complementary currency)
  • CLF Unidad de Fomento (funds code)
  • CNH Chinese yuan when traded in Hong Kong
  • COU Unidad de Valor Real (UVR) (funds code)
  • MXV Mexican Unidad de Inversion (UDI) (funds code)
  • USN United States dollar (next day) (funds code)
  • USS United States dollar (same day) (funds code)
  • UYI Uruguay Peso en Unidades Indexadas (URUIURUI) (funds code)
  • XAG Silver (one troy ounce)
  • XAU Gold (one troy ounce)
  • XBA European Composite Unit (EURCO) (bond market unit)
  • XBB European Monetary Unit (E.M.U.-6) (bond market unit)
  • XBC European Unit of Account 9 (E.U.A.-9) (bond market unit)
  • XBD European Unit of Account 17 (E.U.A.-17) (bond market unit)
  • XDR Special drawing rights
  • XFU UIC franc (special settlement currency)
  • XPD Palladium (one troy ounce)
  • XPT Platinum (one troy ounce)
  • XSU Unified System for Regional Compensation (SUCRE)
  • XTS Code reserved for testing purposes
  • XUA ADB Unit of Account (African Development Bank)
  • XXX No currency
  • ZWD Zimbabwe dollar

Developed by Forma-Pro

Forma-Pro is a full stack development company which interests also spread to open source development. Being a team of strong professionals we have an aim an ability to help community by developing cutting edge solutions in the areas of e-commerce, docker & microservice oriented architecture where we have accumulated a huge many-years experience. Our main specialization is Symfony framework based solution, but we are always looking to the technologies that allow us to do our job the best way. We are committed to creating solutions that revolutionize the way how things are developed in aspects of architecture & scalability.

If you have any questions and inquires about our open source development, this product particularly or any other matter feel free to contact at


Payum\ISO4217 is licensed under the MIT license.