Mastercard · Schema

ThreeDSDefaultData

Enables a Merchant to supply their existing 3-D Secure (3DS) integration details at the time of Digital Payment Application (DPA) registration.

Credit CardsDigital IdentityFinancial ServicesFraud DetectionOpen BankingPaymentsFortune 500

Properties

Name Type Description
defaultAcquirerBin string Allows a Merchant to set a default Acquirer. An Acquirer BIN is an identifier assigned by Mastercard to an Acquirer. If this field is not defined and acquirerData has only one entry, this field will b
defaultAcquirerMerchantId string An identifier assigned to the Merchant by their Acquirer. If this field is not populated and acquirerData has only one entry, this field will be populated with the value from acquirerMerchantId.
defaultMerchantCountryCode string Allows a Merchant to set a default Merchant Country Code (CC). A Merchant CC is a two-character code indicating the country the Merchant is doing business in.
defaultMerchantCategoryCode string Allows a Merchant to set a default Merchant Category Code (MCC). An MCC is a four-character code assigned by Mastercard to the Merchant that indicates the type of business, service, or product provide
View JSON Schema on GitHub

JSON Schema

mastercard-unified-checkout-solutions-three-ds-default-data-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "ThreeDSDefaultData",
  "type": "object",
  "description": "Enables a Merchant to supply their existing 3-D Secure (3DS) integration details at the time of Digital Payment Application (DPA) registration.",
  "properties": {
    "defaultAcquirerBin": {
      "type": "string",
      "description": "Allows a Merchant to set a default Acquirer. An Acquirer BIN is an identifier assigned by Mastercard to an Acquirer.\n\nIf this field is not defined and acquirerData has only one entry, this field will be populated with the value from acquirerBin.\n"
    },
    "defaultAcquirerMerchantId": {
      "type": "string",
      "description": "An identifier assigned to the Merchant by their Acquirer. If this field is not populated and acquirerData has only one entry, this field will be populated with the value from acquirerMerchantId."
    },
    "defaultMerchantCountryCode": {
      "type": "string",
      "description": "Allows a Merchant to set a default Merchant Country Code (CC).\n\nA Merchant CC is a two-character code indicating the country the Merchant is doing business in.\n"
    },
    "defaultMerchantCategoryCode": {
      "type": "string",
      "description": "Allows a Merchant to set a default Merchant Category Code (MCC).\n\nAn MCC is a four-character code assigned by Mastercard to the Merchant that indicates the type of business, service, or product provided by the Merchant.\n\nNote: MCC's may be assigned differently across payment networks. To avoid errors, be sure to use your assigned Mastercard MCC. This code is required for 3-D Secure (3DS) and risk profiling. If the Merchant has more than one MCC, the code most relevant to their business should be used.\n"
    }
  }
}