On This Page
Simple Order API

merchantdefineddata_mddField_1-100

Fields that you can use to store information.
This topic describes the sequence of fields from
merchantDefinedData_mddField_1
 through
merchantDefinedData_mddField_100
.
These fields override the old merchant-defined data fields. For example, if you use the obsolete field
merchantDefinedData_field15
 and the new field
merchantDefinedData_mddField_15
 in the same request, the value for the new field overwrites the value for the obsolete field.
Merchant-defined data fields are not intended to and must not be used to capture personally identifying information. Accordingly, merchants are prohibited from capturing, obtaining, or transmitting any personally identifying information in or through the merchant-defined data fields. Personally identifying information includes, but is not limited to, address, payment card number, social security number, driver's license number, state-issued identification number, passport number, and card verification numbers (CVV, CVC2, CVV2, CID, CVN). In the event
Cybersource
 discovers that a merchant is capturing or transmitting personally identifying information through the merchant-defined data fields, whether or not intentionally,
Cybersource
 will immediately suspend the merchant's account, which will result in a rejection of any and all transaction requests submitted by the merchant after the point of suspension.
Payer Authentication
Only fields 1 through 5 are supported in Payer Authentication. The value appears in the Case Management Details window in the Business Center. The first four fields are the same fields that are used by the Secure Data services.
Visa Platform Connect
For installment payments with Mastercard in Brazil, use
merchantDefinedData_mddField_1
 and
merchantDefinedData_mddField_2
 for data that you want to provide to the issuer to identify the transaction.
For installment payments with Mastercard in Brazil:
  • The value for
    merchantDefinedData_mddField_1
     corresponds to the following data in the TC 33 capture file:
    • Record: CP07 TCR5
    • Position: 25-44
    • Field: Reference Field 2
  • The value for
    merchantDefinedData_mddField_2
     corresponds to the following data in the TC 33 capture file:
    • Record: CP07 TCR5
    • Position: 45-64
    • Field: Reference Field 3

Specifications

  • Installment payments with Mastercard on
    Visa Platform Connect
     in Brazil:
    • Data Type:
       String
    • Data Length:
       20
  • All other transactions:
    • Data Type:
       String
    • Data Length:
       255

Mapping Information

  • REST API Field:
    merchantDefinedInformation[].key
  • SCMP API Field:
    merchant_defined_data1
     through
    merchant_defined_data100
  • Simple Order API Field:
    merchantDefinedData_mddField_1
     through
    merchantDefinedData_mddField_100