# python-iso18245
A Python implementation of the ISO 18245 Merchant Category Codes database.
## Installation
- `pip install iso18245`
## Usage
```py
>>> import iso18245
>>> iso18245.get_mcc("5542")
MCC(range=MCCRange(start='5000', end='5599', description='Retail outlets', reserved=False), iso_description='Automated fuel dispensers', usda_description='Automated Fuel Dispensers', stripe_description='Automated Fuel Dispensers', stripe_code='automated_fuel_dispensers')
>>> iso18245.get_mcc("3000")
MCC(range=MCCRange(start='3000', end='3999', description='Reserved for private use', reserved=True), iso_description='', usda_description='UNITED AIRLINES', stripe_description='', stripe_code='')
>>> iso18245.get_mcc("3000").usda_description
'UNITED AIRLINES'
>>> iso18245.get_mcc("3000").range
MCCRange(start='3000', end='3999', description='Reserved for private use', reserved=True)
>>> iso18245.get_mcc("999999")
Traceback (most recent call last):
…
iso18245.InvalidMCC: 999999
```
## External links
- [Wikipedia: ISO 18245](https://en.wikipedia.org/wiki/ISO_18245)
- [ISO Standard 18245:2023](https://www.iso.org/standard/79450.html)
- [AFNOR: ISO 18245](http://portailgroupe.afnor.fr/public_espacenormalisation/ISOTC68SC7/ISO%2018245.html)
- [Stripe MCC List](https://stripe.com/docs/issuing/categories)
- [USDA MCC List (incl. private MCCs)](https://www.dm.usda.gov/procurement/card/card_x/mcc.pdf)
- [VISA Merchant Data Standards Manual](https://usa.visa.com/content/dam/VCOM/download/merchants/visa-merchant-data-standards-manual.pdf) ([archived](https://web.archive.org/web/20240409085635/https://usa.visa.com/content/dam/VCOM/download/merchants/visa-merchant-data-standards-manual.pdf))
- [Mastercard Quick Reference Booklet](https://www.mastercard.us/content/dam/public/mastercardcom/na/global-site/documents/quick-reference-booklet-merchant.pdf) ([archived](https://web.archive.org/web/20240419100915/https://www.mastercard.us/content/dam/public/mastercardcom/na/global-site/documents/quick-reference-booklet-merchant.pdf))
- [American Express Global Codes & Information Guide](https://www.americanexpress.com/content/dam/amex/us/merchant/new-merchant-specifications/GlobalCodesInfo_FINAL.pdf) ([archived](https://web.archive.org/web/20240419101013/https://www.americanexpress.com/content/dam/amex/us/merchant/new-merchant-specifications/GlobalCodesInfo_FINAL.pdf))
Raw data
{
"_id": null,
"home_page": "https://github.com/jleclanche/python-iso18245",
"name": "iso18245",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.8",
"maintainer_email": null,
"keywords": null,
"author": "Jerome Leclanche",
"author_email": "jerome@leclan.ch",
"download_url": "https://files.pythonhosted.org/packages/5c/de/e8095ac5ac026e4ad23c07d1cb35bc1495051d2ae32c863b246d43e1d9a1/iso18245-1.4.1.tar.gz",
"platform": null,
"description": "# python-iso18245\n\nA Python implementation of the ISO 18245 Merchant Category Codes database.\n\n## Installation\n\n- `pip install iso18245`\n\n## Usage\n\n```py\n\n>>> import iso18245\n>>> iso18245.get_mcc(\"5542\")\nMCC(range=MCCRange(start='5000', end='5599', description='Retail outlets', reserved=False), iso_description='Automated fuel dispensers', usda_description='Automated Fuel Dispensers', stripe_description='Automated Fuel Dispensers', stripe_code='automated_fuel_dispensers')\n>>> iso18245.get_mcc(\"3000\")\nMCC(range=MCCRange(start='3000', end='3999', description='Reserved for private use', reserved=True), iso_description='', usda_description='UNITED AIRLINES', stripe_description='', stripe_code='')\n>>> iso18245.get_mcc(\"3000\").usda_description\n'UNITED AIRLINES'\n>>> iso18245.get_mcc(\"3000\").range\nMCCRange(start='3000', end='3999', description='Reserved for private use', reserved=True)\n>>> iso18245.get_mcc(\"999999\")\nTraceback (most recent call last):\n \u2026\niso18245.InvalidMCC: 999999\n```\n\n## External links\n\n- [Wikipedia: ISO 18245](https://en.wikipedia.org/wiki/ISO_18245)\n- [ISO Standard 18245:2023](https://www.iso.org/standard/79450.html)\n- [AFNOR: ISO 18245](http://portailgroupe.afnor.fr/public_espacenormalisation/ISOTC68SC7/ISO%2018245.html)\n- [Stripe MCC List](https://stripe.com/docs/issuing/categories)\n- [USDA MCC List (incl. private MCCs)](https://www.dm.usda.gov/procurement/card/card_x/mcc.pdf)\n- [VISA Merchant Data Standards Manual](https://usa.visa.com/content/dam/VCOM/download/merchants/visa-merchant-data-standards-manual.pdf) ([archived](https://web.archive.org/web/20240409085635/https://usa.visa.com/content/dam/VCOM/download/merchants/visa-merchant-data-standards-manual.pdf))\n- [Mastercard Quick Reference Booklet](https://www.mastercard.us/content/dam/public/mastercardcom/na/global-site/documents/quick-reference-booklet-merchant.pdf) ([archived](https://web.archive.org/web/20240419100915/https://www.mastercard.us/content/dam/public/mastercardcom/na/global-site/documents/quick-reference-booklet-merchant.pdf))\n- [American Express Global Codes & Information Guide](https://www.americanexpress.com/content/dam/amex/us/merchant/new-merchant-specifications/GlobalCodesInfo_FINAL.pdf) ([archived](https://web.archive.org/web/20240419101013/https://www.americanexpress.com/content/dam/amex/us/merchant/new-merchant-specifications/GlobalCodesInfo_FINAL.pdf))\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "The ISO 18245 Merchant Category Codes database",
"version": "1.4.1",
"project_urls": {
"Homepage": "https://github.com/jleclanche/python-iso18245",
"Repository": "https://github.com/jleclanche/python-iso18245"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cd5eef3e709668014b9ebabb86d05f4848f96ffac406e202c7207b773b3ccc2f",
"md5": "b03d4e8d91dd043e74a099fe2598e0e0",
"sha256": "07fcac02b22044e5f188a7683684f2166900a36d39119eb6ca0f4ef5f0df5772"
},
"downloads": -1,
"filename": "iso18245-1.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b03d4e8d91dd043e74a099fe2598e0e0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.8",
"size": 66746,
"upload_time": "2025-09-03T09:23:05",
"upload_time_iso_8601": "2025-09-03T09:23:05.833859Z",
"url": "https://files.pythonhosted.org/packages/cd/5e/ef3e709668014b9ebabb86d05f4848f96ffac406e202c7207b773b3ccc2f/iso18245-1.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5cdee8095ac5ac026e4ad23c07d1cb35bc1495051d2ae32c863b246d43e1d9a1",
"md5": "2dfc6b15121940703d12aa13f58a4ee4",
"sha256": "1ee69d2b6b6334e29d9131371970a171649a969fe319ae7b09afcfc2ecb02720"
},
"downloads": -1,
"filename": "iso18245-1.4.1.tar.gz",
"has_sig": false,
"md5_digest": "2dfc6b15121940703d12aa13f58a4ee4",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.8",
"size": 50749,
"upload_time": "2025-09-03T09:23:07",
"upload_time_iso_8601": "2025-09-03T09:23:07.299807Z",
"url": "https://files.pythonhosted.org/packages/5c/de/e8095ac5ac026e4ad23c07d1cb35bc1495051d2ae32c863b246d43e1d9a1/iso18245-1.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-03 09:23:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jleclanche",
"github_project": "python-iso18245",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "iso18245"
}
JSON
