Este endpoint permite criar um novo endereço para um cliente específico. É necessário enviar o ID do cliente no path e os dados do endereço (CEP, nome da rua, cidade, estado, país e campos opcionais como número, andar, apartamento e comentários) no corpo da requisição. Em caso de sucesso, a requisição retornará uma resposta com o status 201.
POST
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
OBRIGATÓRIO
400Erro de requisição.
100
As credenciais são obrigatórias. Forneça um token de acesso válido no cabeçalho Authorization.
209
Um parâmetro obrigatório não pode ser nulo. Verifique se todos os campos obrigatórios foram fornecidos com valores válidos.
214
O formato do código postal é inválido. Forneça um código postal válido de acordo com o formato do país.
217
O parâmetro deve ser uma string. Verifique o tipo de dados do campo e certifique-se de que seja enviado como string.
222
O comprimento do parâmetro excede o máximo permitido ou deve ser um valor positivo. Verifique o comprimento do campo e as restrições de valor.
validation_error
Erro de validação. Um ou mais campos falharam na validação. Verifique o corpo da solicitação e certifique-se de que todos os campos obrigatórios estejam formatados corretamente.
401Erro. Access Token não autorizado.
unauthorized
Acesso não autorizado. O token de acesso fornecido é inválido ou expirado. Verifique suas credenciais e tente novamente.
404Erro. Recurso solicitado não encontrado.
not_found
O recurso solicitado não foi encontrado. Verifique se o ID do cliente e o ID do endereço estão corretos e se o endereço existe.
500Erro genérico.
internal_error
Erro interno do servidor. Tente novamente mais tarde ou entre em contato com o suporte se o problema persistir.
curl -X POST \
'https://api.mercadopago.com/v1/customers/{id}/addresses'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-d '{
"zip_code": "03940",
"street_name": "Rua Exemplo",
"street_number": 1602,
"name": "Home",
"phone": "987-654-321",
"floor": "3",
"apartment": "A",
"comments": "Near the park",
"city": {
"id": "BR-SP-44",
"name": "México"
},
"state": {
"id": "BR-SP",
"name": "CDMX"
},
"neighborhood": {
"name": "Crédito Constructor"
}
}'{
"id": "1162600213",
"phone": "987-654-321",
"name": "Home",
"floor": "3",
"apartment": "A",
"street_name": "Rua Exemplo",
"street_number": "1602",
"zip_code": "03940",
"city": {
"id": "BR-SP-44",
"name": "México"
},
"state": {
"id": "BR-SP",
"name": "São Paulo"
},
"country": {
"id": "MX",
"name": "México"
},
"neighborhood": {
"name": "Crédito Constructor"
},
"municipality": {},
"comments": "Near the park",
"date_created": "2021-03-16T15:45:17.000-04:00",
"normalized": true,
"live_mode": true,
"verifications": {}
}