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>