Saltar al contenido
DotPay Developers
DocumentaciónReferencia de API

Direcciones de México

Captura una dirección en México y selecciona su ubicación por código postal.

La Dirección es un objeto del núcleo que distintas funciones de DotPay pueden vincular a sus registros. Esta guía cubre las direcciones de México, cuyo código de país es MX. En el registro de comercios, la Dirección corresponde al domicilio fiscal del comercio.

Captura una dirección

  1. Ingresa el código postal de cinco dígitos. Conserva los ceros iniciales.
  2. Consulta el código postal y selecciona la opción que corresponda a la dirección. Si varias colonias comparten el código, usa la colonia y el municipio o alcaldía para elegir la opción correcta. La opción elegida indica el estado, el municipio o alcaldía y, cuando figuren en el catálogo, la ciudad y la colonia.
  3. Captura la calle y el número exterior. El número exterior admite texto como 12B o S/N si el inmueble carece de número. Agrega el número interior si corresponde a un departamento, oficina o local.

Si el catálogo omite la ciudad, consulta el municipio o alcaldía en su propio campo. La búsqueda por código postal valida la combinación de datos geográficos. La existencia de la calle, la entrega de correspondencia y la comprobación del domicilio requieren verificaciones por separado.

Usa la API de direcciones

El catálogo de códigos postales ficticios de la demostración es público. Consulta el código postal 01234 con el país MX. Envía country, postal_code, catalog_version y entry_id del mismo resultado. DotPay toma los nombres de los campos geográficos de esa opción. Envía la calle y ambos números como texto, por ejemplo Calle de Ejemplo, número exterior 12B y número interior 2A.

Envía solo direcciones ficticias en el perfil fiscal del comercio. Cualquier persona puede consultar o actualizar la dirección desde el perfil compartido. La referencia de API de Direcciones incluye los esquemas de lectura y escritura y la operación de consulta.

Resuelve problemas de búsqueda y validación

Qué ocurreQué hacer
El código postal es inválido (400).Ingresa exactamente cinco dígitos.
La búsqueda devuelve 200 con la lista items vacía.Comprueba el código postal y vuelve a buscarlo.
La opción nueva ya no está vigente o no coincide con el código postal (400 al guardar).Haz una nueva búsqueda y usa los valores de una sola coincidencia vigente.
La búsqueda no está disponible (503).Vuelve a intentarlo cuando esté disponible. Conserva los datos de calle y números que ya capturaste.

En esta página