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. For more information about custom fields, see Custom object definitions.
Enable Level 2 and Level 3 card data submission
On Zuora's Global Payments gateway instance configuration page, complete the following tasks:
- 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.
- 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