Skip to main content

Level 2 and Level 3 card data support for Global Payments

Zuora

Level 2 and Level 3 card data support for Global Payments

This payment gateway integration can be requested through the Specialized Payment Connections service at an additional cost.

The Global Payments payment gateway integration gives you the flexibility to submit Level 2 and Level 3 credit card data.

Prerequisites

  • In Global Payments, set up Level 2 and Level 3 requests in your Global Payments merchant account correctly. 
  • In Zuora, configure the CommodityCode and ProductCode custom fields on the Product Rate Plan Charge object. The API names (without "__c") of these custom fields are required when configuring a Global Payments gateway instance.

Enable Level 2 and Level 3 card data submission

On Zuora's Global Payments gateway instance configuration page, complete the following tasks:

  1. Select Enable L2 and Enable L3.

    With these settings enabled, additional information such as the amount of sales tax and order and line items will be passed to the gateway when processing a credit card transaction. This information might result in lower interchange rates on eligible commercial, corporate, and purchasing cards. For more information about Zuora's support for Level 3 and Level 2 data, see Level 2 and Level 3 Card Data.

  2. In the CommodityCode Custom Field API Name and ProductCode Custom Field API Name fields, enter the API names of the following custom fields of the Product Rate Plan Charge object:
    Configuration Field Custom Field
    CommodityCode Custom Field API Name CommodityCode
    ProductCode Custom Field API Name ProductCode

    Enter the API name without the __c suffix. These two fields are required to qualify your merchant account for Level 3 interchange rates. If these fields are not specified, the Level 3 data will not be sent to the gateway. 

Field mappings

The table in this section describes the data mappings between Zuora and Global Payments for Level 2 and Level 3 processing. For a detailed description of each field, see Global Payments documentation, which is accessible only after signing in to the Global Payments Developer Center.

  Zuora Field Global Payments API Field Required

Level 2 card data

gwOptions_InvoiceDiscount

Sale.Request.Invoice.DiscountAmount

Y

gwOptions_ShippingAmount

Sale.Request.Invoice.ShippingAmount

Y

gwOptions_DutyAmount

Sale.Request.Invoice.DutyAmount

Y

gwOptions_SoldToContactZip

Sale.Request.Invoice.DestinationPostalCode

Y

gwOptions_ShipFromZip

Sale.Request.Invoice.ShipFromPostalCode

Y

gwOptions_TaxExempt

Sale.Request.Invoice.taxIndicator

N

gwOptions_ProductDescription

Sale.Request.Invoice.ProductDescription

N

Level 3 card data

InvoiceDetailDescription

Sale.Request.Invoice.LineItems.LineItem.Description

Y

InvoiceDetailQuantity

Sale.Request.Invoice.LineItems.LineItem.Quantity

Y

InvoiceDetailUOM

Sale.Request.Invoice.LineItems.LineItem.UnitOfMeasure

Y

InvoiceDetailUnitCost

Sale.Request.Invoice.LineItems.LineItem.UnitCost

Y

InvoiceDetailDiscountAmnt

Sale.Request.Invoice.LineItems.LineItem.DiscountAmount

Y

InvoiceDetailAmntWithoutTax

Sale.Request.Invoice.LineItems.LineItem.TotalAmount

Y

InvoiceDetailTaxAmnt

Sale.Request.Invoice.LineItems.LineItem.TaxAmount

Y

RatePlanChargeCommodityCode

Sale.Request.Invoice.LineItems.LineItem.CommodityCode

N

RatePlanChargeProductCode

Sale.Request.Invoice.LineItems.LineItem.Upc

N

Related information