/v1/customers/:id
BASE URI https://api.mercadopago.com/v1/customers/{id}
Request Params
ParameterTypeDescription
first_name
String (a-zA-Z)
Nome do cliente.
last_name
String (a-zA-Z)
Sobrenome do cliente.
phone
Object
Telefone do cliente.
area_code
String
Código de área.
number
String
Número de telefone.
identification
Object
Informações sobre a identificação do cliente.
type
String
Tipo de identificação.
number
String
Número de identificação.
default_address
String
Endereço por defeito do cliente.
address
Object
Informação sobre o endereço padrão do cliente.
id
String
Identificador do endereço do cliente.
zip_code
String
Código postal.
street_name
String
Rua.
street_number
String
O Número.
date_registered
Date(ISO_8601)
Data de registo do cliente.
description
String
Descrição do cliente.
metadata
Object
Metadata do cliente.
default_card
String
Cartão padrão do cliente.
Error Codes
CodeDescription
400 BAD_REQUEST
100
the credentials are required.
101
the customer already exist.
102
missing customer id.
103
parameter must be an object
104
parameter length is too large.
105
the customer id is invalid.
106
the email format is invalid.
107
the first_name is invalid.
108
the last_name is invalid.
109
the phone.area_code is invalid.
110
the phone.number is invalid.
111
the identification.type is invalid.
112
the identification.number is invalid.
113
the address.zip_code is invalid.
114
the address.street_name is invalid.
115
the date_registered format is invalid.
116
the description is invalid.
117
the metadata is invalid.
118
the body must be a Json Object.
119
the card is required.
120
card not found.
121
the card is invalid.
122
the card data is invalid.
123
the payment_method_id is required.
124
the issuer_id is required.
125
invalid parameters.
126
invalid parameter. You cannot update the email.
127
invalid parameter. Cannot resolve the payment method of card, check the payment_method_id and issuer_id.
128
the email format is invalid. Use 'test_payer_[0-9]{1,10}@testuser.com'.
129
the customer has reached the maximum allowed number of cards.
140
invalid card owner.
150
invalid users involved.
200
invalid range format (range=:date_parameter:after::date_from,before::date_to).
201
range attribute must belong to date entity.
202
invalid 'after' parameter. It should be date[iso_8601].
203
invalid 'before' parameter. It should be date[iso_8601].
204
invalid filters format.
205
invalid query format.
206
attributes to sort must belong to 'customer' entity.
207
order filter must be 'asc' or 'desc'.
208
invalid 'sort' parameter format.
401 UNAUTHORIZED
unauthorized
unauthorized.
404 NOT_FOUND
not_found
not_found.