Comunidade de Desenvolvedores maxiPago!

Estorno

O Estorno é a reversão de uma transação de cartão de crédito, debitando o valor do estabelecimento e devolvendo-o ao portador. O estorno é uma operação financeira e envolve outros departamentos dentro das adquirentes e por esta razão, em geral os estornos demoram alguns dias para serem aprovados.

A tabela abaixo indica o prazo de resposta de um Estorno para cada adquirente:

ADQUIRENTE

PRAZO DE RESPOSTA

CIELO

Online, resposta imediata

REDE

2 – 3 Dias úteis

ELAVON

2 – 3 Dias úteis

GETNET

2 – 3 Dias úteis

STONE

Online, resposta imediata

No caso das adquirentes que não possuem resposta online, após solicitar um estorno o estabelecimento deverá checar o status da transação na maxiPago! para verificar se a operação foi aprovada pela adquirente. Enquanto a adquirente não responde, o estorno ficará como pendente em nossa plataforma. Na Cielo, os estornos nos cartões American Express só podem ser totais, não é permitido estorno parcial.

ATENÇÃO:

O serviço de cancelamento da GetNet é realizado apenas via portal do cliente da GetNet.

Estorno – URLs Para Envio dos Dados

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

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

Estorno – 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>
        <return>
            <orderID>0A0104A3:01621AEB218F:EC41:3905FF2F</orderID>
            <referenceNum>Sandbox_teste_1</referenceNum>
            <payment>
                <chargeTotal>100.00</chargeTotal>
            </payment>
        </return>
    </order>
</transaction-request>

Estorno – Exemplo de Retorno em Caso de Sucesso

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
        <authCode/>
        <orderID>0A0104A3:01621AEB218F:EC41:3905FF2F</orderID>
        <referenceNum>Sandbox_teste_1<</referenceNum>
        <transactionID>1791950<</transactionID>
        <transactionTimestamp>1520872985<transactionTimestamp>
        <responseCode>0</responseCode>
        <responseMessage>CAPTURED</responseMessage>
        <avsResponseCode/>
        <cvvResponseCode/>
        <processorCode>A</processorCode>
        <processorMessage>APPROVED</processorMessage>
        <processorName>SIMULATOR</processorName>
        <errorMessage/>
        <creditCardScheme>Mastercard</creditCardScheme>
</transaction-response>

Estorno – Exemplo de Retorno em de Erro

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
        <authCode/>
        <orderID/>
        <referenceNum/>
        <transactionID/>
        <transactionTimestamp>1509379633<transactionTimestamp>
        <responseCode>1024</responseCode>
        <responseMessage>INVALID REQUEST</responseMessage>
        <avsResponseCode/>
        <cvvResponseCode/>
        <processorCode/>
        <processorMessage/>
        <errorMessage>
            The Return amount is greater than the amount that can be returned.
        </errorMessage>
        <creditCardScheme>Mastercard</creditCardScheme>
</transaction-response>

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

orderID

Sim

128

Id do pedido, gerado pela maxiPago! Deve-se salvar este campo para futuras referências ao pedido.

referenceNum

Sim

128

ID do pedido gerado pelo estabelecimento

chargeTotal

Sim

14.2

Valor a ser estornado ao consumidor.