A Transação de Zero Dollar verifica previamente se o cartão utilizado (número, CVV e data de validade) é válido e o diferencial desta funcionalidade é que não ocorre nenhuma cobrança para o portador do cartão, isto é, o cartão é validado sem que o cliente seja sensibilizado, sendo totalmente transparente para o portador do cartão.

Esta transação não permite nenhuma ação posterior (captura, cancelamento, entre outros).

Hoje o serviço de Zero Dollar funciona com as Bandeiras conforme manual da Rede.

URLs Para Envio dos Dados

SANDBOX: https://testapi.maxipago.net/UniversalAPI/postXML

PRODUÇÃO: https://api.maxipago.net/UniversalAPI/postXML

Exemplo de Requisição

<transaction-request>
	<version>3.1.1.15</version>
	<verification>
		<merchantId>100</merchantId>
		<merchantKey>secret-key</merchantKey>
	</verification>
	<order>
		<zeroDollar>
			<processorID>1</processorID>
			<referenceNum>123456789</referenceNum>
			<transactionDetail>
				<payType>
					<creditCard>
						<number>4111111111111111</number>
						<expMonth>12</expMonth>
						<expYear>2020</expYear>
						<cvvNumber>999</cvvNumber>
					</creditCard>
				</payType>
			</transactionDetail>
			<payment>
				<chargeTotal>00.00</chargeTotal>
			</payment>
		</zeroDollar>
	</order>
</transaction-request>

Tabela de Parâmetros

Salvar o cartão automaticamente com Zero Dollar

É possível também salvar o número de cartão automaticamente durante uma operação de autorização ou venda direta.

Como um cartão precisa sempre estar associado a um cadastro, é preciso executar o comando add-consumer antes de se poder salvar o cartão. Também é preciso enviar os dados de cobrança (<billing/>), descritos anteriormente neste manual.

Para indicar que deseja salvar o cartão automaticamente é preciso incluir, dentro do nó da operação (<zeroDollar/>), o elemento <saveOnFile/>, que aceita os seguintes parâmetros:

Exemplo de Request com Token e Ação de salvar o cartão automaticamente

<transaction-request>
	<version>3.1.1.15</version>
	<verification>
		<merchantId>100</merchantId>
		<merchantKey>secret-key</merchantKey>
	</verification>
	<order>
		<zeroDollar>
			<processorID>1</processorID>
			<referenceNum>123456789</referenceNum>
			<transactionDetail>
				<payType>
					<creditCard>
						<number>4111111111111111</number>
						<expMonth>12</expMonth>
						<expYear>2020</expYear>
						<cvvNumber>999</cvvNumber>
					</creditCard>
				</payType>
			</transactionDetail>
			<payment>
				<chargeTotal>00.00</chargeTotal>
			</payment>
			<saveOnFile>
				<customerToken>999</customerToken>
				<onFileEndDate>12/25/2020</onFileEndDate>
			</saveOnFile>
		</zeroDollar>
	</order>
</transaction-request>

Tabela de Parâmetros