Comunidade de Desenvolvedores maxiPago!

Captura

Após realizar uma autorização ou pré-autorização com sucesso, será necessário realizar a confirmação (captura desta transação para que a cobrança seja efetivada e lançada na fatura do portador do cartão).

Captura Total X Captura Parcial

Algumas Adquirentes permitem que o estabelecimento faça uma captura parcial do pedido. Isto significa que, apesar de se ter uma autorização feita no valor total do pedido, o estabelecimento capturará apenas uma parte dela, deixando o resto do valor vencer.

Isto é particularmente útil quando o cliente pede mais de um produto no mesmo pedido e um deles não está mais disponível no estoque. Digamos que temos pedido formado por dois produtos, um de R$60,00 e outro de R$40,00, que já foram autorizados em sua totalidade (R$100,00). Contudo, a checagem de estoque mostra que o segundo produto, de R$40,00, está em falta. Neste caso o estabelecimento pode fazer uma captura parcial de R$60,00, completar parte de sua venda e notificar o cliente do ocorrido.

ATENÇÃO:

Um pedido nunca está completo se a captura não foi feita. Sem ela o Estabelecimento não garante que receberá o valor devido pela Adquirente!

Captura – URLs Para Envio dos Dados

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

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

Captura – 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>
        <capture>
            <orderID>0A0104A3:01621AACC4D6:3867:47710E49</orderID>
            <referenceNum>Sandbox_teste_1</referenceNum>
            <payment>
                <chargeTotal>100.00</chargeTotal>
            </payment>
        </capture>
    </order>
</transaction-request>

Captura – Exemplo de Retorno em Caso de Sucesso


<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
    <authCode/>
    <orderID>0A0104A3:01621AACC4D6:3867:47710E49</orderID>
    <referenceNum>Sandbox_teste_1</referenceNum>
    <transactionID>1791913</transactionID>
    <transactionTimestamp>1520868164</transactionTimestamp>
    <responseCode>0</responseCode>
    <responseMessage>CAPTURED</responseMessage>
    <avsResponseCode/>
    <cvvResponseCode/>
    <processorCode>A</processorCode>
    <processorMessage>APPROVED</processorMessage>
    <processorName>SIMULATOR</processorName>
    <errorMessage/>
    <processorTransactionID>792135</processorTransactionID>
    <processorReferenceNumber>534901</processorReferenceNumber>
    <creditCardScheme>Mastercard</creditCardScheme>
</transaction-response>

Captura – Exemplo de Retorno em de Erro

<?xml version="1.0" encoding="UTF-8"?>
<transaction-response>
    <authCode/>
    <orderID/>
    <referenceNum/>
    <transactionID/>
    <transactionTimestamp>1493906791</transactionTimestamp>
    <responseCode>1024</responseCode>
    <responseMessage>INVALID REQUEST</responseMessage>
    <avsResponseCode/>
    <cvvResponseCode/>
    <processorCode/>
    <processorMessage/>
    <errorMessage>Captured Transaction Amount is more than the Authorized Amount</errorMessage>
    <creditCardScheme>Visa</creditCardScheme>
</transaction-response>

Captura – Tabela de Parâmetros