Actualizar cliente/v1/customers/{id}Renueva los datos de un cliente. Indica el ID del cliente y envía los parámetros con la información que quieras actualizar.
PUT
Productos que lo utilizan:
Parámetros para la solicitud
idnumber
Localización: pathIdentificador de clienteREQUERIDO
address
Localización: bodyInformación sobre la dirección por defecto del clienteobject
date_registered
Localización: bodyFecha de registro del clienteDate(ISO_8601)
default_address
Localización: bodyDirección por defecto del clienteString
Parámetros de respuesta
id
Localización: bodyIdentificador de clientestring
email
Localización: bodyEmail del clientestring
first_name
Localización: bodyNombre del clientestring
last_name
Localización: bodyApellido del clientestring
Solicitud
curl
curl -X PUT \
'https://api.mercadopago.com/v1/customers/{id}' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"email": "jhon@doe.com",
"first_name": "Jhon",
"last_name": "Doe",
"phone": {
"area_code": "55",
"number": "991234567"
},
"identification": {
"type": "CPF",
"number": "12345678900"
},
"default_address": "Home",
"address": {
"id": "123123",
"zip_code": "01234567",
"street_name": "Rua Exemplo",
"street_number": 123
},
"date_registered": "22021-10-20T11:37:30.000-04:00",
"description": "Description del user",
"default_card": "None"
}'
Respuesta
json
{
"id": "000000001-sT93QZFAsfxU9P5",
"email": "jhon@doe.com",
"first_name": "Bruce",
"last_name": "Wayne",
"phone": {
"area_code": 23,
"number": 12345678
},
"identification": {
"type": "DNI",
"number": 12345678
},
"address": {
"zip_code": "SG1 2AX",
"street_name": "Old Knebworth Ln"
},
"description": "This is my description",
"date_created": "2018-02-20T15:36:23.541Z",
"metadata": {},
"cards": [
{}
],
"addresses": [
{}
]
}
Errores
400bad_request
100
101El cliente ya existe.
102missing customer id.
103El parámetro debe ser un objeto
104La longitud del parámetro es muy grande.
105El identificador de cliente es inválido.
106El formato de email es inválido.
107first_name inválido.
108last_name inválido.
109phone.area_code inválido.
110phone.number inválido.
111identification.type inválido.
112identification.number inválido.
113address.zip_code inválido.
114address.street_name inválido.
115date_registered format inválido.
116description inválido.
117metadata inválido.
118El body debe ser un objeto JSON.
119La tarjeta es requerida.
120Tarjeta no encontrada.
121La tarjeta es inválida.
122card data inválida.
123payment_method_id es requerido.
124issuer_id es requerido.
125Parámetros inválidos.
126Parámetro inválido. No se puede actualizar el email.
127Parámetro inválido. No se puede resolver el medio de pago de la tarjeta, revisa payment_method_id y issuer_id.
128El formato de email es inválido. Usa 'test_payer_[0-9]{1,10}@testuser.com'.
129El cliente llego al máximo permitido de tarjetas.
140Dueño de tarjeta inválido.
150Usuarios inválidos involucrados.
200Formato de rango inválido (range=:date_parameter:after::date_from,before::date_to).
201El atributo del rango debe pertenecer a la entidad date.
202Parámetro 'after' inválido. Debería ser date[iso_8601].
203Parámetro 'before' inválido. Debería ser date[iso_8601].
204Formato inválido de filtros.
205Formato de consulta inválido.
206Los atributos a ordenar deben perstenecer a la entidad 'customer'.
207El orden del filtro debe ser 'asc' o 'desc'.
208Formato inválido del parámetro 'sort'.
401bad_request
unauthorizedNo autorizado.
404bad_request
not_foundEl recurso no se ha encontrado.