TransactionsByReference

TransactionsByReference

The TransactionsByReference web method can lookup specific transactions based on the token assigned by Merchantware.

Arguments

Name Type Size Description
merchantName string 1-160 The name of the business or organization owning the Merchantware account.
merchantSiteId string 8-160 The site identifier of a location or storefront owned by the Merchantware account owner.
merchantKey string 1-160 The software key or password for the site accessing a Merchantware account.
token string 1-100 The token identifier returned from a previous transaction.

Return Values

An array of TransactionReference4 is returned.

Notes

The reference ID is usually a number, but may have other forms depending on the card and transaction type. Avoid making the assumption that it is always a number.

Card numbers are always truncated. It is not possible to retrieve the original card number from this method.

SOAP Information

SOAPAction
http://schemas.merchantwarehouse.com/merchantware/40/Reports/TransactionsByReference
Sample Request Packet (raw)
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <TransactionsByReference
     xmlns="http://schemas.merchantwarehouse.com/merchantware/40/Reports/">
      <merchantName>Zero Inc.</merchantName>
      <merchantSiteId>00000000</merchantSiteId>
      <merchantKey>00000-00000-00000-00000-00000</merchantKey>
      <token>375814</token>
    </TransactionsByReference>
  </soap:Body>
</soap:Envelope>
Sample Response Packet (raw)
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
 xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <TransactionsByReferenceResponse
     xmlns="http://schemas.merchantwarehouse.com/merchantware/40/Reports/">
      <TransactionsByReferenceResult>
        <TransactionReference4>
          <Token>375814</Token>
          <InvoiceNumber>9980</InvoiceNumber>
          <TransactionDate>2008-04-22 20:11:28.217</TransactionDate>
          <ApprovalStatus>DECLINED</ApprovalStatus>
          <Cardholder>John Doe</Cardholder>
          <Amount>1.06</Amount>
          <Type>1</Type>
          <CardNumber>************1117</CardNumber>
          <CardType>2</CardType>
          <AuthorizationCode>14087</AuthorizationCode>
          <MerchantTransactionId>DEV101</MerchantTransactionId>
          <BatchNumber>159</BatchNumber>
        </TransactionReference4>
      </TransactionsByReferenceResult>
    </TransactionsByReferenceResponse>
  </soap:Body>
</soap:Envelope>