Obter um cliente - Clientes - Mercado Pago Developers
Developers
Referência API
Suporte
Entrar

    Introdução

    LISTA DE API

    Preferências

    Criar uma preferência

    POST

    Pesquisar preferências

    GET

    Obter uma preferência

    GET

    Atualizar uma preferência

    PUT

    Tipos de documento

    Obter tipos de documentos

    GET

    Meios de pagamento

    Obter meios de pagamento

    GET

    Pagamentos

    Criar um pagamento

    POST

    Pesquisar pagamentos

    GET

    Obter um pagamento

    GET

    Atualizar um pagamento

    PUT

    Estornos

    Obter um estorno

    GET

    Clientes

    Criar um cliente

    POST

    Pesquisar clientes

    GET

    Obter um cliente

    GET

    Atualizar um cliente

    PUT

    Cartões

    Salvar um cartão

    POST

    Obter cartões de um cliente

    GET

    Obter um cartão

    GET

    Atualizar um cartão

    PUT

    Excluir um cartão

    DELETE

    Lojas

    Obter uma Loja

    GET

    Criar uma Loja

    POST

    Pesquisar lojas

    GET

    Atualizar uma Loja

    PUT

    Excluir uma Loja

    DELETE

    Caixa

    Criar um Caixa

    POST

    Pesquisar caixas

    GET

    Obter um Caixa

    GET

    Atualizar um Caixa

    PUT

    Excluir um Caixa

    DELETE

    Ordens presenciais

    Criar uma ordem

    POST

    Excluir uma ordem

    DELETE

    Ordens presenciais v2

    Criar uma ordem

    PUT

    Obter uma ordem

    GET

    Excluir uma ordem

    DELETE

    Ordens

    Criar uma ordem

    POST

    Pesquisar ordens

    GET

    Obter uma ordem

    GET

    Atualizar uma ordem

    PUT

    Preferência de assinatura

    Criar uma assinatura

    POST

Obter um cliente

GET

/v1/customers/{id}
Veja todas as informações de um cliente a partir da sua identificação.
Produtos relacionados:
Marketplace
Mobile Checkout
Parâmetros de requisição
id

OBRIGATÓRIO

number
Localização: pathCustomer's Id
Parâmetros de resposta
id
string
Localização: bodyIdentificador de cliente
email
string
Localização: bodyE-mail do cliente
first_name
string
Localização: bodyNome do cliente
last_name
string
Localização: bodySobrenome do cliente
Solicitação
curl
curl -X GET \
    'https://api.mercadopago.com/v1/customers/{id}' \
    -H 'Authorization: Bearer ACCESS_TOKEN_ENV' 
Resposta
json
{
  "id": "470183340-cpunOI7UsIHlHr",
  "email": "comprador_mlb01+470183340@asdf12.com.br",
  "first_name": "Customer",
  "last_name": "Tester",
  "phone": {
    "area_code": "11",
    "number": "97654321"
  },
  "identification": {
    "type": "CPF",
    "number": "19119119100"
  },
  "address": {
    "id": "1162600213",
    "zip_code": "05187010",
    "street_name": "Caetano Poli, 12"
  },
  "description": "Customer Test",
  "date_created": "2021-03-16T15:45:17.000-04:00",
  "metadata": {
    "source_sync": "source_ws"
  },
  "default_address": "1162600213",
  "cards": {
    "payment_method": {},
    "security_code": {},
    "issuer": {},
    "cardholder": {}
  },
  "addresses": {
    "id": "1162600213",
    "street_name": "Caetano Poli, 12",
    "zip_code": "05187010",
    "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 (Zona Oeste)"
    },
    "municipality": {},
    "date_created": "2021-03-16T15:45:17.000-04:00"
  },
  "live_mode": true
}
Erros
400bad_request
100the credentials are required.
101the customer already exist.
102missing customer id.
103parameter must be an object
104parameter length is too large.
105the customer id is invalid.
106the email format is invalid.
107the first_name is invalid.
108the last_name is invalid.
109the phone.area_code is invalid.
110the phone.number is invalid.
111the identification.type is invalid.
112the identification.number is invalid.
113the address.zip_code is invalid.
114the address.street_name is invalid.
115the date_registered format is invalid.
116the description is invalid.
117the metadata is invalid.
118the body must be a Json Object.
119the card is required.
120card not found.
121the card is invalid.
122the card data is invalid.
123the payment_method_id is required.
124the issuer_id is required.
125invalid parameters.
126invalid parameter. You cannot update the email.
127invalid parameter. Cannot resolve the payment method of card, check the payment_method_id and issuer_id.
128the email format is invalid. Use 'test_payer_[0-9]{1,10}@testuser.com'.
129the customer has reached the maximum allowed number of cards.
140invalid card owner.
150invalid users involved.
200invalid range format (range=:date_parameter:after::date_from,before::date_to).
201range attribute must belong to date entity.
202invalid 'after' parameter. It should be date[iso_8601].
203invalid 'before' parameter. It should be date[iso_8601].
204invalid filters format.
205invalid query format.
206attributes to sort must belong to 'customer' entity.
207order filter must be 'asc' or 'desc'.
208invalid 'sort' parameter format.
401bad_request
unauthorizedunauthorized.
404bad_request
not_foundnot_found.
Essas informações foram úteis?

Copyright © 1999-2021 DeRemate.com de Uruguay S.R.L.

Termos e condiçõesComo cuidamos da sua privacidade
Central de vendedores

Al navegar en este sitio aceptas las cookies que utilizamos para mejorar tu experiencia. Más información.