https://github.com/jleclanche/python-iso18245
Python implementation of the ISO 18245 Merchant Category Codes database ⛺
https://github.com/jleclanche/python-iso18245
banking finance fintech iso iso18245 mcc python
Last synced: about 2 months ago
JSON representation
Python implementation of the ISO 18245 Merchant Category Codes database ⛺
- Host: GitHub
- URL: https://github.com/jleclanche/python-iso18245
- Owner: jleclanche
- License: mit
- Created: 2020-04-19T19:16:26.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-11-21T11:15:32.000Z (6 months ago)
- Last Synced: 2025-03-28T16:06:36.563Z (about 2 months ago)
- Topics: banking, finance, fintech, iso, iso18245, mcc, python
- Language: Python
- Homepage: https://pypi.org/project/iso18245/
- Size: 73.2 KB
- Stars: 56
- Watchers: 5
- Forks: 22
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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))