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

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

referenceNum

Sim

128

Identificador do pedido no estabelecimentoEste campo aceita apenas valores alfanuméricos e deve ser único.

orderID

Sim

128

ID do pedido gerado pela maxipago! Deve-se salvar este campo para futuras referências ao pedido.

chargeTotal

Siim

14.2

Valor do Pedido