Os pedidos são identificados pelo elemento orderID. Nos casos a seguir, um único orderID, pode ter mais de uma transação (transactionID):
- Autorização e captura separadas são duas transações agrupadas no mesmo OrderID.
- Recorrência (todas as transações de uma recorrência têm o mesmo orderID).
- Boleto (Existe a possibilidade de emitir mais de um boleto no mesmo OrderID, como por exemplo uma remissão trocando apenas data de vencimento).
Para estes casos (especialmente as recorrências) pode ser muito útil pesquisar pelo orderID para ver todas as transações agrupadas no mesmo orderID.
Para filtrar uma única transação deve-se usar o elemento </filterOptions>
, dentro da tag </request>
:
Consultar Pedido – URLs Para Envio dos Dados
SANDBOX: https://testapi.maxipago.net/ReportsAPI/servlet/ReportsAPI
PRODUÇÃO: https://api.maxipago.net/ReportsAPI/servlet/ReportsAPI
Consultar Pedido – 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> <orderId>0A011599:015C44CF07A1:C036:70C0D3C1</orderId> </filterOptions> </request> </rapi-request>
Consultar Pedido – 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:00:18</time> </header> <result> <resultSetInfo> <totalNumberOfRecords>1</totalNumberOfRecords> <pageToken>temp1495803618529.1</pageToken> <pageNumber>1</pageNumber> <numberOfPages>1</numberOfPages> </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 Pedido – 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>