ISO 3166 Migration
Release Details
Release date: Sep 6, 2024
The old fields will be deprecated by Nov 30th 2024.
Please make sure you have migrated your integration to the new standards before November 30th, 2024.
Release Type
Informational
Summary
Zero Hash is migrating to ISO 3166 standards for Country and Subdivision Codes to streamline implementation and avoid any ambiguity around country names. Note that this relates to country of residence, citizenship and optionally id issuing authority.
The following guide should be used as an integration reference.
At this time, this is NOT a breaking change.
- All current participants are updated to include a
jurisdiction_code. - For new participants Zero Hash will accept either Country & State OR jurisdiction_code, we will back fill the other fields until November 30th, 2024.
Action Required
Reach out to your relationship manager to learn more about the integration process.
We advise Platforms to begin working on migrating to the ISO 3166 standards as we will deprecate the legacy fields officially on November 30th, 2024.
Platforms using the Onboarding SDK:
Platforms using our Onboarding SDK do not have to make any change to Onboard new participants. However, GET /participants will now return jurisdiction_code as well as country and state.