DetailedTransactionByReference

DetailedTransactionByReference

DetailedTransactionByReference

The DetailedTransactionByReference web method can lookup detailed information about a specific transaction 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

A DetailedTransactionReference4 along with a SupportedActions is returned.

For an EMV transaction an Emv is returned.

If there are Health Care Amounts in the transaction data a HealthCareAmountDetails is returned.

Notes

The token 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/DetailedTransactionByReference
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>
    <DetailedTransactionByReference
     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>
    </DetailedTransactionByReference>
  </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>
    <DetailedTransactionByReferenceResponse
     xmlns="http://schemas.merchantwarehouse.com/merchantware/40/Reports/">
      <DetailedTransactionByReferenceResult>
        <ApprovalCode></ApprovalCode>
        <ApprovalStatus>DECLINED</ApprovalStatus>
        <AuthorizationAmount>5.00</AuthorizationAmount>
        <AvsResponse></AvsResponse>
        <BatchNumber></BatchNumber>
        <Cardholder>John Doe</Cardholder>
        <CashBackAmount>1.00</CashBackAmount>
        <CardNumber>************1117</CardNumber>
        <CardType>2</CardType>
        <ConvenienceAmount>1.00</ConvenienceAmount>
        <CustomerId></CustomerId>
        <CvvResponse></CvvResponse>
        <DiscountAmount></DiscountAmount>
        <ErrorMessage></ErrorMessage>
        <ExpirationDate>1222</ExpirationDate>
        <HostReference>14087</HostReference>
        <InvoiceNumber>9980</InvoiceNumber>
        <IsCardNumberKeyed>true</IsCardNumberKeyed>
        <IsTransactionAdjusted>false</IsTransactionAdjusted>
        <IsTransactionCaptured>false</IsTransactionCaptured>
        <IsTransactionVoided>false</IsTransactionVoided>
        <IsTransactionSettled>false</IsTransactionSettled>
        <MerchantTransactionId>DEV101</MerchantTransactionId>
        <OriginalToken></OriginalToken>
        <PostalCode>02110</PostalCode>
        <PurchaseOrderNumber>101750</PurchaseOrderNumber>
        <RegisterNumber>15</RegisterNumber>
        <StreetAddress>123 Main Street</StreetAddress>
        <SupportedActions>
          <AdjustmentToken></AdjustmentToken>
          <CaptureToken></CaptureToken>
          <EmailReceiptToken>375814</EmailReceiptToken>
          <RefundMaxAmount>5.00</RefundMaxAmount>
          <RefundToken></RefundToken>
          <RepeatSaleToken>375814</RepeatSaleToken>
          <VoidToken></VoidToken>
        </SupportedActions>
        <SurchargeAmount></SurchargeAmount>
        <TaxAmount>0.25</TaxAmount>
        <TipAmount>1.00</TipAmount>
        <Token>375814</Token>
        <TotalAmount>6.00</TotalAmount>
        <TransactionDate>2008-04-22 20:11:28.217</TransactionDate>
        <TransactionType>1</TransactionType>
        <UserName>GWAPITEST</UserName>
        <FsaCard>false</FsaCard>
        <HealthCareAmountDetails>
            <CopayAmount>2.00</CopayAmount>
            <ClinicalAmount>3.00</ClinicalAmount>
            <DentalAmount>1.00</DentalAmount>
            <HealthCareTotalAmount>15.00</HealthCareTotalAmount>
            <PrescriptionAmount>4.00</PrescriptionAmount>
            <VisionAmount>5.00</VisionAmount>
        </HealthCareAmountDetails>
        <Emv>
            <ApplicationInformation>
                <Aid>A0000000031010</Aid>
                <ApplicationLabel>VISA CREDIT</ApplicationLabel>
                <ApplicationExpiryDate>12/31/2022</ApplicationExpiryDate>
                <ApplicationEffectiveDate>01/01/2014</ApplicationEffectiveDate>
                <ApplicationInterchangeProfile>5C00</ApplicationInterchangeProfile>
                <ApplicationVersionNumber>008C</ApplicationVersionNumber>
                <ApplicationTransactionCounter>1680</ApplicationTransactionCounter>
                <ApplicationUsageControl>FF80</ApplicationUsageControl>
                <ApplicationPreferredName>VISA CREDIT 3</ApplicationPreferredName>
                <ApplicationDisplayName>VISA CREDIT 3</ApplicationDisplayName>
            </ApplicationInformation>
            <CardInformation>
                <MaskedPan>XXXXXXXXXXXXXXXX</MaskedPan>
                <PanSequenceNumber>XX</PanSequenceNumber>
                <CardExpiryDate>1222</CardExpiryDate>
            </CardInformation>
            <ApplicationCryptogram>
                <CryptogramType>TC</CryptogramType>               
                <Cryptogram>D4EF490CC3CA74D5</Cryptogram>
            </ApplicationCryptogram>
            <CVMResults>410302</CVMResults>
            <IssuerApplicationData>06020103A40000</IssuerApplicationData>
            <TerminalVerificationResults>0200008000</TerminalVerificationResults>
            <UnpredictableNumber>4B119B92</UnpredictableNumber>
            <Amount>
                <AmountAuthorized>6.00</AmountAuthorized>               
                <AmountOther>0.00</AmountOther>
            </Amount>
            <PosEntryMode>05</PosEntryMode>
            <TerminalInformation>
                <TerminalType>22</TerminalType>
                <IfdSerialNumber>87654321</IfdSerialNumber>
                <TerminalCountryCode>0840</TerminalCountryCode>
                <TerminalID>12345678</TerminalID>
                <TerminalActionCodeDefault>DC4000A800</TerminalActionCodeDefault>
                <TerminalActionCodeDenial>0010000000</TerminalActionCodeDenial>
                <TerminalActionCodeOnline>DC4004F800</TerminalActionCodeOnline>
            </TerminalInformation>
            <TransactionInformation>
                <TransactionType>00</TransactionType>
                <TransactionCurrencyCode>0840</TransactionCurrencyCode>
                <TransactionStatusInformation>E800</TransactionStatusInformation>
            </TransactionInformation>
            <CryptogramInformationData>40</CryptogramInformationData>
            <PINStatement>PIN VERIFIED</PINStatement>
            <CvmMethod>000000000000000045035E03</CvmMethod>
            <IssuerActionCodeDefault>FC50ECA800</IssuerActionCodeDefault>
            <IssuerActionCodeDenial>0000000000</IssuerActionCodeDenial>
            <IssuerActionCodeOnline>FC50ECA800</IssuerActionCodeOnline>
            <AuthorizationResponseCode>3030</AuthorizationResponseCode>
            <EntryMode>Contact</EntryMode>
        </Emv>
      </DetailedTransactionByReferenceResult>
    </DetailedTransactionByReferenceResponse>
  </soap:Body>
</soap:Envelope>