Criar um Cadastro do Cliente

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

<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>

Exemplo de Retorno em caso de sucesso

<?xml version="1.0" encoding="UTF-8" ?>
<api-response>
	<errorCode>0</errorCode>
	<errorMessage></errorMessage>
	<command>add-consumer</command>
	<time>1678283556872</time>
	<result>
		<customerId>86975768</customerId>
	</result>
</api-response>

Importante: Os dados retornados no parâmetro: <customerId> devem ser reservados para uso futuro.

Exemplo de Retorno em caso de erro

<api-response>
    <errorCode>1</errorCode>
    <errorMessage>
        <![CDATA[Parser Error: URI=null Line=1: cvc-maxLength-valid: Value '93515441654541874647584614684884648541641164154164564154184310041' with length = '65' is not facet-valid with respect to maxLength '64' for type '#AnonType_customerIdExt'.]]>
    </errorMessage>
    <time>1678285394553</time>
</api-response>

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.