Express Level III Details

Document created by Worldpay Developer Community Support Team on May 11, 2016Last modified by jhess on Nov 12, 2019
Version 3Show Document
  • View in full screen mode

Level III Enhanced and Line Item Details should be submitted in addition to existing Level II Details.  Recommended Level II Details may include: SalesTaxAmount, CommercialCardCustomerCode, TicketNumber, BillingName, and ShippingZipcode.

 

  • Level III Enhanced and Line Item Details are supported via the XML interface only (not available via SOAP interface).
  • Level III Enhanced and Line Item Details are supported in both card-present (Retail) and card-not-present (Direct Marketing/MOTO, Ecommerce) industry types.
  • Level III Enhanced and Line Item Details are supported via TSYS, First Data, and Vantiv processing platforms only.
  • When Level III Enhanced and Line Item Detail data is submitted, ALL Enhanced and Line Item Detail fields must be included in the request.  Depending on the merchant setup, some processors may reject missing Enhanced data, while others may not, but per the ExpressPay Interface Specification, ALL Enhanced and Line Item Detail data should be submitted for ALL Level III transactions.
  • Level III Enhanced and Line Item Details supported for Visa and MasterCard transactions only.
  • Level III Enhanced and Line Item Details are limited to fifty (50) line items in a single transaction.
  • Where necessary (and sometimes, but not always, based on the CommercialCardResponseCode), the CreditCardAdjustment method can be used to update original CreditCardSale, CreditCardAuthorizationCompletion, or CreditCardForce requests to include Level III Details (along with original Level II Details).  When CreditCardAdjustment is used on original CreditCardReturn or CreditCardCredit offline transaction requests, the Level III Enhanced and Line Item Details may simply be ignored by ExpressPay.
  • Note that the CommercialCardResponseCode is returned for both Visa and MasterCard commercial cards on the TSYS platform, but only for Visa commercial cards on the First Data and Vantiv platforms.
  • For Summary and Item Commodity Codes, we recommend visiting http://www.unspsc.org or http://bhs.econ.census.gov/bhs/cfs/Commodity%20Code%20Manual%20(CFS-1200).pdf or http://www.foreign-trade.com/reference/hscode.htm for further information.

 

To prevent transaction downgrades, Level III Line Item Details and Amounts should balance((item UnitCost * item Quantity) + total SalesTaxAmount = total TransactionAmount).  This must be the case for the totals of all line items.

 

 

Processing Flow

 

Sale Transactions (charge immediately)

  1. The software application will submit a standard CreditCardSale request (without any Level III information).  If the card processed is a commercial card, a response value called CommercialCardResponseCode will be returned indicating the card is a type of commercial card.  This will identify the commercial card as a Business Card, Corporate Card, or Purchasing Card.
  2. Where applicable and when Level III information is available, a CreditCardAdjustment request (containing Level III Enhanced and Line Item Details) will be submitted to adjust the original CreditCardSale to include Level III information for settlement.  ALL Level III Enhanced and Line Item Details are required when including this Level III Data.
  3. Sale transaction batches out and settles automatically during the overnight hours.

Authorization and Authorization Completion Transactions (charge when shipped)

  1. The software application will submit a standard CreditCardAuthorization request (without any Level III information).  If the card processed is a commercial card, a response value called CommercialCardResponseCode will be returned indicating the card is a type of commercial card.  This will identify the commercial card as a Business Card, Corporate Card, or Purchasing Card.
  2. Where applicable and when Level III information is available, a CreditCardAuthorizationCompletion request (containing Level III Enhanced and Line Item Details) will be submitted to complete the original CreditCardAuthorization to include Level III information for settlement.  ALL Level III Enhanced and Line Item Details are required when including this Level III Data.
  3. Completion transaction batches out and settles automatically during the overnight hours.

Force Transactions (charge immediately)

  1. Upon receiving a voice authorization response, the software application will submit a standard CreditCardForce request (without any Level III information). Depending on the information known about the card, the software may choose to include Level III details by generating a CreditCardAdjustment request to include Level III details as a secondary step in the process.  Whenever provided, ALL Level III details are required when including this Enhanced Data.
  2. Where applicable and when Level III information is available, a CreditCardAdjustment request (containing Level III Enhanced and Line Item Details) will be submitted to adjust the original CreditCardForce to include Level III information for settlement.  ALL Level III Enhanced and Line Item Details are required when including this Level III Data.
  3. Force transaction batches out and settles automatically during the overnight hours.


 

 

Sample XML Format (using ExtendedParameters)

EnhancedData and LineItemDetail MUST be in the order shown below

 

<ExtendedParameters>
 
<EnhancedData>

    <MerchantVATRegistrationNumber />
    <CustomerVATRegistrationNumber />
    <SummaryCommodityCode />
    <DiscountAmount />
    <FreightAmount />
    <DutyAmount />
    <DestinationZIPCode />
    <ShipFromZIPCode />
    <DestinationCountryCode />
    <UniqueVATInvoiceReferenceNumber />
    <OrderDate />
    <VATAmount />
    <VATRate />
    <LineItemCount />
    <AlternateTaxAmount />
    <NationalTaxAmount />
 
<LineItemDetail>

      <LineItem>
        <ItemCommodityCode />
        <ItemDescription />
        <ProductCode />
        <Quantity />
        <UnitOfMeasure />
        <UnitCost />
        <LineItemVATAmount />
        <LineItemVATRate />
        <LineItemDiscountAmount />
        <LineItemTotalAmount />
        <AlternateTaxIdentifier />
        <VATType />
        <DiscountCode />
        <NetGrossCode />
        <ExtendedItemAmount />
        <DebitCreditCode />
        <ItemDiscountRate />
      </LineItem>
      <LineItem>
      </LineItem>
    </LineItemDetail>
  </EnhancedData>
</ExtendedParameters>

1 person found this helpful

Outcomes