Criar um cadstro do cliente é o primeiro passo a ser realizado antes de se adicionar um cartão à base, através do comando add-consumer.
URLs para criar 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>add-consumer</command> <request> <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> </request> </api-request>
Os parâmetros aceitos no add-consumer
Os parâmetros aceitos no comando add-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 criar um cadastro: add-consumer |
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 |
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 |