generated: '2026-10-12'
method: derived
generator: derive-vocabulary.py
source:
- openapi/mastercard-access-api-openapi.yml
- openapi/mastercard-account-groups-api-openapi.yml
- openapi/mastercard-account-opening-api-openapi.yml
- openapi/mastercard-account-subscriptions-api-openapi.yml
- openapi/mastercard-accounts-api-openapi.yml
vocabulary:
  name: Mastercard Domain Vocabulary
  description: 'Terms declared by Mastercard''s own API contract: its resource groups, objects and enumerations, with the contract''s definitions.
    Derived, not authored.'
  version: '2026-10-12'
  terms:
  - term: Account Groups
    definition: Operations related to Account Groups.
    tags:
    - Resource Group
    source: openapi/mastercard-account-groups-api-openapi.yml
  - term: Accounts
    definition: Operations related to Accounts.
    tags:
    - Resource Group
    source: openapi/mastercard-accounts-api-openapi.yml
  - term: Agreements
    definition: API endpoints used by CSP to create agreements and manage lifecycle of agreements.
    tags:
    - Resource Group
    source: openapi/mastercard-agreements-api-openapi.yml
  - term: Approvals
    definition: The API provides ability for the lender to approve a BNPL loan during purchase.
    tags:
    - Resource Group
    source: openapi/mastercard-approvals-api-openapi.yml
  - term: Benefit-Allocations-Card-Management
    definition: Endpoints to freeze/unfreeze a card and replace a card for a cardholder.
    tags:
    - Resource Group
    source: openapi/mastercard-benefit-allocations-card-management-api-openapi.yml
  - term: Benefit-Allocations-Segment-Management
    definition: Endpoints to assign, cancel or replace a segment to a card.
    tags:
    - Resource Group
    source: openapi/mastercard-benefit-allocations-segment-management-api-openapi.yml
  - term: Benefits
    definition: Handles Benefits
    tags:
    - Resource Group
    source: openapi/mastercard-benefits-api-openapi.yml
  - term: Callbacks
    definition: This API is to be used by the payment provider to notify payment status to relevant Mastercard Applications in case the payment
      was initiated by the Mastercard Application.
    tags:
    - Resource Group
    source: openapi/mastercard-callbacks-api-openapi.yml
  - term: Categories
    definition: Returns a list of merchant categories
    tags:
    - Resource Group
    source: openapi/mastercard-categories-api-openapi.yml
  - term: CLS Activations
    definition: Operations related to CLS activations.
    tags:
    - Resource Group
    source: openapi/mastercard-cls-activations-api-openapi.yml
  - term: Countries
    definition: Retrieve a list of countries and country subdivisions
    tags:
    - Resource Group
    source: openapi/mastercard-countries-api-openapi.yml
  - term: Donors
    definition: Donors
    tags:
    - Resource Group
    source: openapi/mastercard-donors-api-openapi.yml
  - term: Issuer
    definition: Contains APIs which will be consumed by the Issuer's backend system.
    tags:
    - Resource Group
    source: openapi/mastercard-issuer-api-openapi.yml
  - term: Lookup Identifiers
    definition: Operations related to Lookup Identifiers.
    tags:
    - Resource Group
    source: openapi/mastercard-lookup-identifiers-api-openapi.yml
  - term: Lost Stolen
    definition: Operations related to Lost Stolen.
    tags:
    - Resource Group
    source: openapi/mastercard-lost-stolen-api-openapi.yml
  - term: Notifications
    definition: Notification Operations - Retrieving collection of generated notifications
    tags:
    - Resource Group
    source: openapi/mastercard-notifications-api-openapi.yml
  - term: PAN Blocks
    definition: Operations related to PAN Blocks.
    tags:
    - Resource Group
    source: openapi/mastercard-pan-blocks-api-openapi.yml
  - term: Products
    definition: Handles Products
    tags:
    - Resource Group
    source: openapi/mastercard-products-api-openapi.yml
  - term: Scores
    definition: Retrieval of Mastercard transaction-based credit scores and data insights.
    tags:
    - Resource Group
    source: openapi/mastercard-scores-api-openapi.yml
  - term: Subscription
    definition: Subscription Operations - Creating, retrieving, updating and deleting subscriptions
    tags:
    - Resource Group
    source: openapi/mastercard-subscription-api-openapi.yml
  - term: Transactions
    definition: Transactions API
    tags:
    - Resource Group
    source: openapi/mastercard-transactions-api-openapi.yml
  - term: Validations
    definition: This API is to be used to validate customer information present within relevant Mastercard Applications.
    tags:
    - Resource Group
    source: openapi/mastercard-validations-api-openapi.yml
  - term: CountryCode
    definition: The country code of the country where the transaction originates from.
    tags:
    - Object
    source: openapi/mastercard-access-api-openapi.yml#/components/schemas/CountryCode
  - term: TpAuditMetadata
    definition: Object containing metadata related to the request.
    tags:
    - Object
    source: openapi/mastercard-access-api-openapi.yml#/components/schemas/TpAuditMetadata
  - term: ErrorResponse
    definition: The error response model used by all the API endpoints.
    tags:
    - Object
    source: openapi/mastercard-access-api-openapi.yml#/components/schemas/ErrorResponse
  - term: AccessToken
    definition: 'Object declared by the contract with fields: transactionId, sdkToken, apiDataCenter.'
    tags:
    - Object
    source: openapi/mastercard-access-api-openapi.yml#/components/schemas/AccessToken
  - term: AccessTokenCommonFields
    definition: 'Object declared by the contract with fields: countryCode, sdkVersion, channelType, userProfileId, sdkAuditEvents, tpAuditMetadata,
      arid.'
    tags:
    - Object
    source: openapi/mastercard-access-api-openapi.yml#/components/schemas/AccessTokenCommonFields
  - term: SdkVersion
    definition: Mastercard SDK version integrated with TP App, it is a constant extracted from MIDS SDK Configurations (generated while bundling
      SDK artifacts). If the TP app supports split PDS, this attribute MUST be specified.
    tags:
    - Object
    source: openapi/mastercard-access-api-openapi.yml#/components/schemas/SdkVersion
  - term: ARID
    definition: A unique identifier for any activity being executed arising out of a Claim Share request. This value is passed as a parameter
      in the URL redirecting a User to the TP Flow during a Claim Share.
    tags:
    - Object
    source: openapi/mastercard-access-api-openapi.yml#/components/schemas/ARID
  - term: AuditEventsItem
    definition: 'Object declared by the contract with fields: dateTime, softwareVersion, userProfileId, sessionId, transactionGroupId, logRequestFlow,
      logEvent, logEventType, osVersion, deviceMake, type, audit.'
    tags:
    - Object
    source: openapi/mastercard-access-api-openapi.yml#/components/schemas/AuditEventsItem
  - term: ErrorsWrapper
    definition: 'Object declared by the contract with fields: Errors.'
    tags:
    - Object
    source: openapi/mastercard-account-groups-api-openapi.yml#/components/schemas/ErrorsWrapper
  - term: Errors
    definition: 'Object declared by the contract with fields: Error.'
    tags:
    - Object
    source: openapi/mastercard-account-groups-api-openapi.yml#/components/schemas/Errors
  - term: AccountGroupDetails
    definition: 'Object declared by the contract with fields: actionCode, sourceId, sourceIdType, targetId, targetIdType.'
    tags:
    - Object
    source: openapi/mastercard-account-groups-api-openapi.yml#/components/schemas/AccountGroupDetails
  - term: ErrorItem
    definition: Error Details
    tags:
    - Object
    source: openapi/mastercard-account-groups-api-openapi.yml#/components/schemas/ErrorItem
  - term: UserScores
    definition: Scores that were calculated by analyzing the provided user data.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/UserScores
  - term: UserDetails
    definition: More granular details of the user insights.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/UserDetails
  - term: ErrorList
    definition: The error response model used by all of our API endpoints
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/ErrorList
  - term: DeviceTrustFactor
    definition: An integer between 1-5 (1 being no trust and 5 being high trust). The trust factor value reflects the trustworthiness of the attributes
      associated with this device.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/DeviceTrustFactor
  - term: ErrorMessage
    definition: The error response model used by all of our API endpoints.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/ErrorMessage
  - term: DeviceDetails
    definition: More granular details of the device insights.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/DeviceDetails
  - term: IPRiskScore
    definition: Comprehensive risk score associated with an IP address, with a higher score indicating a riskier individual. A number between
      0 and 1 rounded to three decimal places.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/IPRiskScore
  - term: MatchToName
    definition: 'The match status between the input name and the queried entity. Possible values are: * no-match * not-found * match'
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/MatchToName
  - term: DeviceInsightFactor
    definition: The calculated device risk is represented numerically using a range from 1 (no/low risk) to 5 (high risk). Each numerical value
      and its associated risk representation is shown below. * `1` - Represents a no or low risk request. * `2` - Represents a low risk request.
      * `3` - Represents a medium risk request. * `4` - Represents a high risk request. * `5` - Represents a very high risk request. The ca
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/DeviceInsightFactor
  - term: Error
    definition: The error response model used by all of our API endpoints
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/Error
  - term: PhoneAnalysis
    definition: Results from analyzing a particular phone number.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/PhoneAnalysis
  - term: BrowserPlugins
    definition: A list of browser plugins installed on the consumer device.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/BrowserPlugins
  - term: InsightsList
    definition: List of the types of insights returned.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/InsightsList
  - term: UserInput
    definition: Input related to the user (account and either email or phone are required).
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/UserInput
  - term: DeviceInput
    definition: 'Input related to the device. The fields required in this section vary depending on the output needed: * IP * Optional to generate
      user insights * Required to generate IP and device insights * User Agent * Optional to generate user and IP insights * Required to generate
      device insights * Other fields * Optional fields that can enhance device insights * If any of these fields are provided then IP an'
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/DeviceInput
  - term: PhoneNumber
    definition: Phone number including country hint (only the number is required).
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/PhoneNumber
  - term: DeviceInsights
    definition: Insights generated by analyzing the provided device data.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/DeviceInsights
  - term: BrowserUserAgent
    definition: The user-agent string of the consumer device. The user-agent must represent the HTTP client of the service consumer with details
      on the software originating the request.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/BrowserUserAgent
  - term: UDID
    definition: The generated unique device identifier.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/UDID
  - term: Address
    definition: Full address including country, state, and postal code.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/Address
  - term: DeviceScores
    definition: Scores that were calculated by analyzing the provided device data.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/DeviceScores
  - term: DeviceRiskFactor
    definition: The calculated risk factor is represented numerically using a range from 1 (no/low risk) to 5 (high risk). Each numerical value
      and its associated risk representation is shown below. * `1` - Represents a no or low risk request. * `2` - Represents a low risk request.
      * `3` - Represents a medium risk request. * `4` - Represents a high risk request. * `5` - Represents a very high risk request. The ca
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/DeviceRiskFactor
  - term: AccountOpeningInsights
    definition: All insights generated by analyzing the provided data.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/AccountOpeningInsights
  - term: IPInsights
    definition: Insights generated by analyzing the provided IP address.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/IPInsights
  - term: UserInsights
    definition: Insights generated by analyzing the provided user data.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/UserInsights
  - term: EmailAnalysis
    definition: Results from analyzing a particular email address.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/EmailAnalysis
  - term: AccountInfo
    definition: Data points related to the account
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/AccountInfo
  - term: IPDetails
    definition: Results from analyzing the provided IP address.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/IPDetails
  - term: IdentityRiskScore
    definition: Comprehensive identity risk score with a higher score indicating a riskier account sign-up.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/IdentityRiskScore
  - term: AccountOpeningData
    definition: All input related to the opening of the account. User input is required for all requests. Device input is only required if IP
      and/or device insights are needed.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/AccountOpeningData
  - term: DeviceID
    definition: This field contains device identification information.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/DeviceID
  - term: DeviceInfo
    definition: This field contains information related to the consumer device used to authorize with your product or service.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/DeviceInfo
  - term: AddressAnalysis
    definition: Results from analyzing a particular address.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/AddressAnalysis
  - term: IPScores
    definition: Scores calculated by analyzing the provided IP address.
    tags:
    - Object
    source: openapi/mastercard-account-opening-api-openapi.yml#/components/schemas/IPScores
  - term: CustomerAccount
    definition: 'Object declared by the contract with fields: requestId, customer, account.'
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/CustomerAccount
  - term: Expiry
    definition: The expiration date associated to the account number being inquired upon. Must be in MMYY format.
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/Expiry
  - term: MerchantId
    definition: A merchant ID or payment facilitator ID, previously registered with Mastercard.
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/MerchantId
  - term: Ica
    definition: A number assigned by Mastercard to a licensed customer to identify the member in transactions. This is used as an identifier for
      data submitted to ABU.
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/Ica
  - term: SubMerchantId
    definition: An optional identifier for a sub-merchant of a payment facilitators under a registered merchant ID.
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/SubMerchantId
  - term: Customer
    definition: Representation of a customer
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/Customer
  - term: AccountNumber
    definition: The account number being inquired upon.
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/AccountNumber
  - term: Account
    definition: Representation of an account
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/Account
  - term: ErrorWrapper
    definition: 'Object declared by the contract with fields: Errors.'
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/ErrorWrapper
  - term: BaseCustomer
    definition: Properties common to all customer
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/BaseCustomer
  - term: BaseAccount
    definition: Properties common to all accounts
    tags:
    - Object
    source: openapi/mastercard-account-subscriptions-api-openapi.yml#/components/schemas/BaseAccount
  - term: AccountEnroll
    definition: 'Object declared by the contract with fields: accountId, accountIdType, status, productCode, programIdentifier, openDate, enrollmentDate,
      accruePoints, householdToken, primaryAccount, userDefined1, userDefined2. (14 more)'
    tags:
    - Object
    source: openapi/mastercard-accounts-api-openapi.yml#/components/schemas/AccountEnroll