O Void é o cancelamento de uma captura antes do fechamento do lote final do dia. Se por alguma razão o pedido não pode ser completado e a transação já foi capturada o Void cancela a venda efetuada, anulando aquela transação.
IMPORTANTE:
– o Void só é permitido até as 23:59 do dia da captura (horário de Brasília).
– o Void é usado para transações de cartão de crédito e débito.
Cancelamento – URLs Para Envio dos Dados
SANDBOX: https://testapi.maxipago.net/UniversalAPI/postXML
PRODUÇÃO: https://api.maxipago.net/UniversalAPI/postXML
Cancelamento – Exemplo de Requisição
<?xml version="1.0" encoding="UTF-8"?> <transaction-request> <version>3.1.1.15</version> <verification> <merchantId>store-id</merchantId> <merchantKey>store-key</merchantKey> </verification> <order> <void> <transactionID>1791850</transactionID> </void> </order> </transaction-request>
Cancelamento – Exemplo de Retorno em Caso de Sucesso
<?xml version="1.0" encoding="UTF-8"?> <transaction-response> <authCode/> <orderID/> <referenceNum/> <transactionID>1791850</transactionID> <transactionTimestamp/> <responseCode>0</responseCode> <responseMessage>VOIDED</responseMessage> <avsResponseCode/> <cvvResponseCode/> <processorCode/> <processorMessage/> <processorName>SIMULATOR</processorName> <errorMessage/> <creditCardScheme>Mastercard</creditCardScheme> </transaction-response>
Cancelamento – Exemplo de Retorno em de Erro
<?xml version="1.0" encoding="UTF-8"?> <api-error> <errorCode>1</errorCode> <errorMsg> <errorMsg> </api-error>
<?xml version="1.0" encoding="UTF-8"?> <api-error> <errorCode>1</errorCode> <errorMsg> <errorMsg> </api-error>
Cancelamento – Tabela de Parâmetros
Nome |
Obrigatório |
Tamanho |
Descrição |
version |
Sim |
11 |
Versão da API |
merchantId |
Sim |
20 |
Id de Loja que identifica o estabelecimento |
merchantKey |
Sim |
80 |
Chave associada ao ID da Loja |
transactionID |
Sim |
64 |
Id da transação, gerado pela maxiPago! Deve-se salvar este campo para futuras referências ao pedido. |