Esta guía te indica cómo enviar correctamente el país en la API usando el estándar ISO 3166-1.1. Qué debes enviar#
En el JSON debes usar estos campos:countryCode: código ISO 3166-1 alfa-2 de 2 letras.
countryName: nombre del país.
{
"countryCode": "CO",
"countryName": "Colombia"
}
2. Regla simple para no fallar#
1.
Usa en countryCode un valor ISO alfa-2 en mayúscula.
2.
Envía en countryName el nombre del país correspondiente.
3.
Asegura que countryCode y countryName coincidan entre sí.
3. Códigos ISO 3166-1 más usados#
| countryCode | countryName |
|---|
CO | Colombia |
US | Estados Unidos |
MX | México |
AR | Argentina |
CL | Chile |
PE | Perú |
EC | Ecuador |
PA | Panamá |
BR | Brasil |
ES | España |
4. Ejemplos rápidos#
{
"countryCode": "CO",
"countryName": "Colombia"
}
Cliente en Estados Unidos:{
"countryCode": "US",
"countryName": "Estados Unidos"
}
{
"countryCode": "MX",
"countryName": "México"
}
5. Validaciones recomendadas en la API#
Rechaza countryCode vacío o nulo.
Valida que countryCode tenga exactamente 2 letras mayúsculas.
Valida que el código exista en ISO 3166-1 alfa-2.
Rechaza inconsistencias entre countryCode y countryName.
6. Errores comunes#
Enviar countryCode con 3 letras, por ejemplo COL, cuando debes enviar alfa-2, por ejemplo CO.
Enviar countryCode en minúscula, por ejemplo co.
Enviar countryName que no corresponde al código.
Enviar solo countryName sin countryCode.
7. Checklist antes de enviar#
countryCode está informado y en formato ISO alfa-2.
countryName está informado.
El código y el nombre corresponden al mismo país.
Modificado en 2026-03-11 15:51:50