Actualizar dirección

Este endpoint permite actualizar los datos de una dirección existente. Debes enviar el ID del cliente y el ID de la dirección en el path y, en el cuerpo de la solicitud, los campos que quieras actualizar (código postal, nombre de la calle, ciudad, estado, país y campos opcionales). En caso de éxito, la solicitud devolverá una respuesta con el estado 200 que contiene la dirección actualizada.

PUT

https://api.mercadopago.com/v1/customers/{id}/addresses/{address_id}
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
Path
id
string

REQUERIDO

Identificador de cliente.
address_id
string

REQUERIDO

Identificador de la dirección.
Body
zip_code
string
Código postal de la dirección. Longitud máxima: 255. Solo alfanumérico: A-Z, a-z, 0-9, guión, guión bajo. Sin espacios ni acentos.
street_name
string
Nombre de la calle. Longitud máxima: 255. Solo ASCII (sin acentos, ej. sin ñ, ã, é).
street_number
number
Número de la calle. Entero. Si se envía, debe ser positivo (mayor que cero).
name
string
Nombre/etiqueta de la dirección. Longitud máxima: 255. Letras (con acentos), espacios, apóstrofo, guión. Sin números ni símbolos (@, #, etc.).
Response parameters
id
string
Identificador de la dirección.
phone
string
Número de teléfono asociado a la dirección.
name
string
Nombre/etiqueta de la dirección.
floor
string
Número de piso.
Errors

400Error.

100

Las credenciales son obligatorias. Proporciona un token de acceso válido en el encabezado Authorization.

214

El formato del código postal es inválido. Proporciona un código postal válido según el formato del país.

217

El parámetro debe ser una cadena de texto. Verifica el tipo de datos del campo y asegúrate de enviarlo como string.

222

La longitud del parámetro excede el máximo permitido o debe ser un valor positivo. Verifica la longitud del campo y las restricciones de valor.

validation_error

Error de validación. Uno o más campos fallaron en la validación. Verifica el cuerpo de la solicitud y asegúrate de que todos los campos obligatorios estén correctamente formateados.

401Error. Access Token no autorizado.

unauthorized

Acceso no autorizado. El token de acceso proporcionado es inválido o ha expirado. Verifica tus credenciales e intenta nuevamente.

404Error. Recurso solicitado no encontrado.

not_found

El recurso solicitado no fue encontrado. Verifica que el ID del cliente y el ID de la dirección sean correctos y que la dirección exista.

500Error genérico.

internal_error

Error interno del servidor. Intenta nuevamente más tarde o contacta con soporte si el problema persiste.

Request
curl -X PUT \
    'https://api.mercadopago.com/v1/customers/{id}/addresses/{address_id}'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer APP_USR-5*********956537-12*********ff1a3d36d*********47e7b9985*********770' \
    -d '{
  "zip_code": "01234567",
  "street_name": "Rua Exemplo",
  "street_number": 123,
  "name": "Home",
  "phone": "11987654321",
  "floor": "3",
  "apartment": "A",
  "comments": "Near the park",
  "city": {
    "id": "BR-SP-44",
    "name": "São Paulo"
  },
  "state": {
    "id": "BR-SP",
    "name": "São Paulo"
  },
  "neighborhood": {
    "name": "Jardim Ipanema"
  }
}'
Response
{
  "id": "1162600213",
  "street_name": "Rua Exemplo",
  "zip_code": "01234567",
  "city": {
    "id": "BR-SP-44",
    "name": "São Paulo"
  },
  "state": {
    "id": "BR-SP",
    "name": "São Paulo"
  },
  "country": {
    "id": "BR",
    "name": "Brasil"
  },
  "neighborhood": {
    "name": "Jardim Ipanema"
  },
  "municipality": {},
  "date_created": "2021-03-16T15:45:17.000-04:00",
  "live_mode": true
}