Comunidade de Desenvolvedores maxiPago!

Consultar Transação

A sondagem de uma única transação permite verificar o seu status e resgatar os detalhes de uma transação. Esta sonda é necessária para confirmar os pagamentos de pedidos feitos com boletos, além de verificar a situação de um estorno solicitado anteriormente.

Para filtrar uma única transação deve-se usar o elemento <filterOptions/>, dentro da tag <request/>:

Consultar Transação – URLs Para Envio dos Dados

SANDBOX: https://testapi.maxipago.net/ReportsAPI/servlet/ReportsAPI

PRODUÇÃO: https://api.maxipago.net/ReportsAPI/servlet/ReportsAPI

Consultar Transação – Exemplo de Requisição

<?xml version="1.0" encoding="UTF-8"?>
<rapi-request>
    <verification>
        <merchantId>store-id</merchantId>
        <merchantKey>store-key</merchantKey>
    </verification>
    <command>transactionDetailReport</command>
    <request>
        <filterOptions>
            <transactionId>176890900</transactionId>
        </filterOptions>
    </request>
</rapi-request>

Consultar Transação – Exemplo de Retorno em Caso de Sucesso

<?xml version="1.0" encoding="UTF-8"?>
<rapi-response>
    <header>
        <errorCode>0</errorCode>
        <errorMsg/>
        <command>transactionDetailReport</command>
        <time>05-26-2017 10:40:03</time>
    </header>
    <result>
        <resultSetInfo>
            <totalNumberOfRecords>1</totalNumberOfRecords>
            <pageNumber>1</pageNumber>
        </resultSetInfo>
        <records>
            <record>
                <transactionId>176890900</transactionId>
                <referenceNumber>
                    <![CDATA[123456789]]>
                </referenceNumber>
                <transactionType>Sale</transactionType>
                <transactionAmount>1.00</transactionAmount>
                <taxAmount>0.00</taxAmount>
                <shippingAmount>0.00</shippingAmount>
                <transactionDate>05/26/2017 09:50:37 AM</transactionDate>
                <orderId>
                    <![CDATA[0A011599:015C44CF07A1:C036:70C0D3C1]]>
                </orderId>
                <splitPaymentOrderId/>
                <userId/>
                <customerId/>
                <companyName>
                    <![CDATA[maxiPago]]>
                </companyName>
                <responseCode>0</responseCode>
                <approvalCode>123456</approvalCode>
                <paymentType>(Hipercard) ...6688</paymentType>
                <bankRoutingNumber/>
                <achAccountNumber/>
                <avsResponseCode>YYY</avsResponseCode>
                <billingName>
                    <![CDATA[Fulano de Tal]]>
                </billingName>
                <billingAddress1>
                    <![CDATA[Av. Republica Brasil, 230]]>
                </billingAddress1>
                <billingAddress2>
                    <![CDATA[14 Andar]]>
                </billingAddress2>
                <billingCity>Sao Paulo</billingCity>
                <billingState>SP</billingState>
                <billingCountry>BR</billingCountry>
                <billingZip>01031170</billingZip>
                <billingPhone>1140099400</billingPhone>
                <billingEmail>
                    <![CDATA[fulanodetal@email.com]]>
                </billingEmail>
                <comments/>
                <transactionStatus>Approved</transactionStatus>
                <transactionState>3</transactionState>
                <recurringPaymentFlag/>
                <processorReturnedData/>
                <gatewayDebitNetworkID/>
                <creditCardType>HIPERCARD</creditCardType>
                <boletoUrl/>
                <boletoNumber/>
                <expirationDate/>
                <processorID>SIMULATOR</processorID>
                <dateOfPayment/>
                <dateOfFunding/>
                <bankOfPayment/>
                <branchOfPayment/>
                <paidAmount/>
                <bankFee/>
                <netAmount/>
                <returnCode>A</returnCode>
                <clearingCode/>
                <customField1/>
                <customField2/>
                <customField3/>
                <customField4/>
                <customField5/>
                <numberOfInstallments/>
                <chargeInterest/>
            </record>
        </records>
    </result>
</rapi-response>

Consultar Transação – Exemplo de Retorno Caso não Localize o Pedido

<?xml version="1.0" encoding="UTF-8"?>
<rapi-response>
    <header>
        <errorCode>0</errorCode>
        <errorMsg/>
        <command>transactionDetailReport</command>
        <time>05-26-2017 10:40:03</time>
    </header>
    <result>
        <resultSetInfo>
            <totalNumberOfRecords>0</totalNumberOfRecords>
            <pageNumber>1</pageNumber>
        </resultSetInfo>
        <records/>
    </result>
</rapi-response>