Modificar cliente - Gestão de cartões e clientes - Mercado Pago Developers

Modificar cliente

Caso ocorra alguma alteração nos dados de um cliente como por exemplo, endereço, cartão ou e-mail da conta, é possível realizar essa alteração através da API de clientes ou dos nossos SDKs.

Na tabela abaixo descrevemos todos os atributos que podem ser modificados, e para realizar a alteração, envie um PUT com o customer_ide os atributos que deseja modificar ao endpoint /v1/customers/{id} e execute a requisição ou, se preferir, utilize um dos SDKs a seguir.

Importante

Caso você não tenha o customer_id, siga os passos descritos na seção Buscar cliente para obter a informação. Além disso, o campo email só pode ser atualizado se o cliente ainda não tiver um e-mail associado.

Atributo	Descrição
`address`	Endereço
`default_address`	Endereço padrão
`default_card`	Cartão padrão
`description`	Descrição
`emai`	E-mail da conta
`first_name`	Nome
`last_name`	Sobrenome
`phone`	Telefone cadastrado
`identification`	Tipo e número do documento

          
<?php

  MercadoPago\SDK::setAccessToken("ENV_ACCESS_TOKEN");

  $customer = new MercadoPago\Customer();
  $customer->email = "user@user.com";
  $customer->first_name = "john";
  $customer->last_name = "wagner";
  $customer->phone = array("area_code" => "11", "number" => "001234567");
  $customer->identification = array("type" => "RUT", "number" => "12341234");
  $customer->default_address = "Casa";
  $customer->address = array("zip_code" => "52", "street_name" => "Av. Apoquindo", "street_number" => "2");
  $customer->description = "Informações do cliente";
  $customer->default_card = "None";
  $customer->update();

?>

          
var mercadopago = require('mercadopago');
mercadopago.configure({
    access_token: 'ENV_ACCESS_TOKEN'
});

var customer_data = { 
  "email": "test_payer_12345@testuser.com",
  "first_name": "john" ,
  "last_name": "wagner",
  "phone": {
    "area_code": "11",
    "number": "001234567"
  },
  "identification": {
    "type": "RUT",
    "number": "12341234"
  }, 
  "default_address": "Casa",
  "address": {
    "zip_code": "52",
    "street_name": "Av. Apoquindo",
    "street_number": "2"
  },
  "description": "Informações do cliente",
  "default_card": "None
 }

mercadopago.customers.update(customer_data).then(function (customer) {
 // code ...
});

          
MercadoPagoConfig.setAccessToken("ENV_ACCESS_TOKEN");

CustomerClient client = new CustomerClient();

CustomerRequest request = CustomerRequest.builder()
   .email("user@user.com")
   .firstName("John")
   .lastName("Wagner")
   .defaultAddress("Casa")
   .phone(PhoneRequest.builder()
       .areaCode("11")
       .number("001234567")
       .build())
   .identification(IdentificationRequest.builder()
       .type("CPF")
       .number("12341234")
       .build())
   .description("Informações do cliente")
   .defaultCard("None")
   .address(CustomerAddressRequest.builder()
       .zipCode("52")
       .streetName("Av. das Nações Unidas")
       .streetNumber(2)
       .build())
   .build();

client.update("247711297-jxOV430go9fx2e", request);

          
require 'mercadopago'

sdk = Mercadopago::SDK.new('ENV_ACCESS_TOKEN')

customer_request = {
  email: 'user@user.com',
  first_name: 'john',
  last_name: 'wagner',
  default_address: 'Casa',
  phone: {
    area_code: '11',
    number: '001234567'
  },
  identification: {
    type: 'RUT',
    number: '12341234'
  },
  address: {
    zip_code: '52',
    street_name: 'Av. Apoquindo',
    street_number: '2'
  },
  description: 'Informações do cliente',
  default_card: 'None'
}
customer_response = sdk.customer.update(customer_id ,customer_request)
customer = customer_response[:response]

          
MercadoPagoConfig.AccessToken = "ENV_ACCESS_TOKEN";
var phoneRequest = new PhoneRequest
{
  AreaCode = "11",
  Number = "001234567"
};

var identificationRequest = new IdentificationRequest
{
  Type = "RUT",
  Number = "12341234"
};

var addressRequest = new AddressRequest
{
  ZipCode = "52",
  StreetName = "Av. Apoquindo",
  StreetNumber = "2"
};

var customerRequest = new CustomerRequest
{
    Email = "test_payer_12345@testuser.com",
    FirstName = "john",
    LastName = "wagner",
    DefaultAddress = "home",
    Description = "Informações do cliente",
    DefaultCard = "None",
    Phone = phoneRequest,
    Identification = identificationRequest,
    Address = addressRequest

};
var customerClient = new CustomerClient();
Customer customer = await customerClient.Update(customerRequest);

          
import mercadopago
sdk = mercadopago.SDK("ENV_ACCESS_TOKEN")

customer_data = {
  "email": 'user@user.com',
  "first_name": 'john',
  "last_name": 'wagner',
  "default_address": 'Casa',
  "phone": {
    "area_code": '11',
    "number": '001234567'
  },
  "identification": {
    "type": 'RUT',
    "number": '12341234'
  },
  "address": {
    "zip_code": '52',
    "street_name": 'Av. Apoquindo',
    "street_number": '2'
  },
  "description": 'Informações do cliente',
  "default_card": 'None'
}
customer_response = sdk.customer().update(customer_id, customer_data)
customer = customer_response["response"]

          
curl -X PUT \
    'https://api.mercadopago.com/v1/customers/{id}' \
    -H 'Authorization: Bearer ACCESS_TOKEN_ENV' \ 
    -d '{
  "email": "user@user.com",
  "first_name": "john",
  "last_name": "wagner",
  "address": {
    "zip_code": "52",
    "street_name": "Av. Apoquindo",
    "street_number": "2"
  },
  "phone": {
    "area_code": "11",
    "number": "001234567"
  },
  "identification": {
    "type": "RUT",
    "number": "12341234"
  },
  "description": "Informações do cliente" 
}'

Exemplo de resposta com o envio do customer_id:

{
  "id": "xxxxxxxxxxxxxxxxxxxxx",
  "email": "user@user.com",
  "first_name": "john",
  "last_name": "wagner",
  "phone": {
    "area_code": "11",
    "number": 001234567
  },
  "identification": {
    "type": "RUT",
    "number": 12341234
  },
  "address": {
    "zip_code": "52",
    "street_name": "Av. Apoquindo",
    "street_number": 2
  },
  "description": "Informações do cliente",
  "date_created": "2021-05-25T15:36:23.541Z",
  "metadata": {},
  "cards": [
    {}
  ],
  "addresses": [
    {}
  ]
}

Exemplo de resposta sem o parâmetro customer_id:

{
  "message": "missing customer id"
}

Create customer and card

Learn how to create customers and associate them with a card.

Search customer

Learn how to search for specific customer data from their email.