Comunidade de Desenvolvedores maxiPago!

Atualizar um Cadastro de Cliente

 

Atualização de um cliente é feito através do comando update-consumer. Os parâmetros aceitos e o formato da chamada são muito similares ao comando add-consumer. A principal diferença é que este método requer o envio do campo customerId.

 

URLs para atualizar um cadastro de cliente

 

Sandbox: https://testapi.maxipago.net/UniversalAPI/postAPI
Produção: https://api.maxipago.net/UniversalAPI/postAPI

 

Exemplo de requisição

 

<api-request>
    <verification>
        <merchantId>store-id</merchantId>
        <merchantKey>store-key</merchantKey>
    </verification>
    <command>update-consumer</command>
    <request>
        <customerId>00000001</customerId>
        <customerIdExt>00000001</customerIdExt>
        <firstName>Fulano</firstName>
        <lastName>de Tal</lastName>
        <address1>Av. Marcos Penteado de Ulhoa Rodrigues, 939</address1>
        <address2>11 Andar</address2>
        <city>Barueri</city>
        <state>SP</state>
        <zip>06360040</zip>
        <country>BR</country>
        <phone>01121218536</phone>
        <email>fulano@dominio.com</email>
        <dob>12/25/1970</dob>
        <sex>M</sex>
        <ssn>12345678901</ssn>
    </request>
</api-request>

 

Os parâmetros aceitos no update-consumer

 

Os parâmetros aceitos no comando update-consumer estão abaixo. Se o campo for vazio, não enviar.

Nome

Obrigatório

Descrição

merchantId

Sim

ID da loja que identifica o Estabelecimento

merchantKey

Sim

Chave associada ao ID da Loja

command

Sim

Comando a ser executado. Para atualizar um cadastro: update-consumer

customerId

Sim

ID único do cadastro, retornado quando o cliente foi adicionado à base

customerIdExt

Sim

Identificador interno do estabelecimento para o cliente

firstName

Sim

Nome do cliente

lastName

Sim

Sobrenome do cliente

address1

Sim

Endereço da residência do cliente

address2

Sim

Complemento do endereço da residência do cliente

city

Sim

Cidade da residência do cliente

state

Sim

UF da residência do cliente 2 letras seguindo padrão brasileiro. ZZ = Fora do Brasil

zip

Sim

CEP da residência do cliente

country

Sim

País da residência do cliente. ISO 3166-2

phone

Sim

Telefone do cliente

email

Sim

E-mail do cliente

dob

Sim

Data de nascimento do cliente Formato MM/DD/AAAA

sex

Sim

Sexo do cliente. F = Feminino | M = Masculino

ssn

Sim

CPF ou CNPJ do cliente Este campo é apenas para referência. Não serão feitas validações dos dados enviados