Skip to main content

Level 2 and Level 3 support for Vantiv (Now Worldpay)

Zuora

Level 2 and Level 3 support for Vantiv (Now Worldpay)

  1. Last updated
  2. Save as PDF

The Vantiv (Now Worldpay) gateway integration gives you the flexibility to submit Level 2 and Level 3 credit card data. 

Supported payment methods

Vantiv (Now Worldpay) supports Level 2 and Level 3 card data processing for the following payment methods:

  • Credit Cards, including:
    • Visa
    • MasterCard
    • American Express
    • Discover
  • Credit Card Reference Transactions

Prerequisites

  • Work with Vantiv (Now Worldpay) to correctly set up Level 2 and Level 3 requests in your merchant account. 
  • In Zuora, configure the CommodityCode custom field on the Product Rate Plan Charge object. The API names (without "__c") of this custom field will be required when configuring a Vantiv (Now Worldpay) gateway instance. For more information about custom fields, see Custom object definitions.
  • VAT ID (cardAcceptorTaxid) is optional. However, if you want to submit it to the gateway, ensure the VAT ID field of your Zuora customer account is specified with your Tax ID.

Enable Level 2 and Level 3 card data submission

To enable Level 2 and Level 3 card data processing in Zuora, complete the following configuration steps on the Vantiv (Now Worldpay) gateway configuration page:

  1. Select Enable L2 or Enable L3.

    By selecting these checkboxes, you agree to send extra information related to a transaction to qualify for certain purchasing interchange rates. The gateway requires extra information, which must be submitted to achieve Level 2 or Level 3 Interchange rates for Visa and MasterCard.

    To enable Level 3 data processing, both checkboxes must be selected.

    For more information about Zuora's support for Level 2 and Level 3 data, see Level 2 and Level 3 Card Data.

  2. In the L3 ItemData Limit field, enter the maximum number of invoice items that can be included in the Level 3 fields. The default value is 98.
     
  3. In the Custom Field Commodity Code API Name field, enter the API name (without the __c suffix) of the CommodityCode custom field on the Product Rate Plan Charge object. This field is required to qualify your merchant account for Visa Level 3 Interchange rates. If Enable L3 is selected, this field is required.

In addition to the previous settings, you can review Pre-conditions for submitting Level 3 data to understand other related configurations.