on2media / us-zip-code-to-state
Maps a US ZIP code to a state
Installs: 34 367
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 0
Open Issues: 0
This package is auto-updated.
Last update: 2024-12-20 06:21:33 UTC
README
Some payment providers require a state to be sent when the cardholder is based in the United States. Rather than add an additional field to our payment form we created this mapping based on data obtained from https://simple.wikipedia.org/wiki/List_of_ZIP_Code_prefixes.
Usage:
$state = (new \On2Media\UsZipCodeToState\UsZipCodeToState())->getState('90210'); // `CA`
Exceptions are thrown if the ZIP code is not five numeric characters or if no match is found.
In addition to state abbreviations (AK, AL, AR, AZ, CA, CO, CT, DE, FL, GA, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MI, MN, MO, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VA, VT, WA, WI, WV, WY) the following other codes are also returned:
- Armed Forces (AA, AE, AP)
- District of Columbia (DC)
- Territories (GU, PR, VI)