Welcome to Zuora Product Documentation

Explore our rich library of product information

Merchant Defined Fields

Zuora supports Verifi's Merchant Defined Fields (MDFs) from MDF1 to MDF20, enabling up to twenty MDFs per transaction for enhanced transaction analysis and fraud mitigation.

Zuora supports all of Verifi's Merchant Defined Fields (MDFs) from MDF1 through MDF20, allowing up to twenty MDFs to be passed per payment method authorization, payment, or refund transaction. MDF Fields are used to provide Verifi with important information about your business that Verifi will use when processing the transaction. Verifi may use this information for advanced transaction analysis, to trigger rules and filtering, as well as dynamically routing transactions. Information passed in these MDF fields should be accurate as the information is especially critical to mitigating and remediating fraud and risk.

MDFs are only supported via the Zuora API, with exception of MDF3 which can be configured when setting up your Verifi payment gateway using the field for "Product" (under Credentials). In the Zuora API, these MDFs are represented like this: Merchant Defined Field 1 is merchant_defined_field_1. If you would like to pass in different data for one of the MDFs in which Zuora passes default information (these are MDF1, MDF 2, MDF3, MDF6, MDF9, MDF18), you can do so utilizing gateway options .

The table below contains 3 columns:

  • Verifi MDF Field Name: This is the name of the field in the Verifi gateway. In the API these fields are represented like this: Merchant Defined Field 1 is merchant_defined_field_1.

  • Verifi Description: Listed are common data points to give you an idea as to the type of data commonly passed in these fields. You may not use all these fields or pass the exact data, as you would only pass the information and MDFs applicable to your business.

  • Zuora Data Passed in MDF Field: Zuora will pass information in these fields by default with every payment and refund transactions (including create/update payment method, payment, create refund). Any of the Zuora data passed can be overriden using Zuora's gateway options , allowing you to customize the data passed in any of the 20 Verifi MDF fields.

Verifi MDF Field Name

Verifi Description

Zuora Data Passed In MDF Field

Merchant Defined Field 1

Customer ID

Customer Account Number

Merchant Defined Field 2

Level of Continuity Indicator Account Age

Total Number of Processed Payments for the Payment Method

Merchant Defined Field 3

Product Group/Brand

Text from the Product Field on the Gateway Configuration

Merchant Defined Field 4

Product ID, SKU(s)

Merchant Defined Field 5

Sales Center ID, URL

Merchant Defined Field 6

Sales Center Agent ID

Customer Account Sales Rep Name

Merchant Defined Field 7

Affiliate ID

Merchant Defined Field 8

Campaign ID

Merchant Defined Field 9

Retry Count (Recurring Payments)

Number of Consecutive Failed Payments for the Payment Method

Merchant Defined Field 10

Shipping Method

Merchant Defined Field 11

Order Channel

Merchant Defined Field 12

Verify Indicator

Merchant Defined Field 13

Refund Indicator

Merchant Defined Field 14

Product Position

Merchant Defined Field 15

Acquisition Cost

Merchant Defined Field 16

Review Indicator

Merchant Defined Field 17

Merchant Defined Field 18

Device Profiling Session ID

Device Session Profiling ID from the Payment Method

Merchant Defined Field 19

Card Product Indicator Code

Merchant Defined Field 20

Verifi Processed