Mastercard Merchant Participation API is one of 249 APIs that Mastercard publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Merchant Participation. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, code examples, a changelog, a support channel, and a getting-started guide.
This API exposes
2 operations
across 1 path,
and defines 43 schemas.
It is described by OpenAPI 2.0, at version 1.0.
Requests are made against the base URL https://api.example.com.
2 operations1 paths43 schemas1 GET1 POST
Metadata
The identity and technical contract details declared by the specification.
The contract defines 43 schemas that model the data the API accepts and returns. The most detailed are Merchant (21 properties), MerchantParticipation (14 properties), Address (6 properties), Error (5 properties). Each schema is shown below with its type and property counts.
acquirerICA
string
ICA of acquirer which will be part of auth transaction. Insert leading zeros to ensure that the acquirerICA is either 6, 9, or 11 characters in length.
duns
string
A unique identifier assigned by Dun and Bradstreet is used to identify a business.
merchantGroup
string
Merchant Group. An identifier used to determine the merchant category type to qualify for the right MAID (MAID is assigned internally by Mastercard). It is imp…
wallet
object
Contains merchant wallet information.
3 properties2 required
status
string
Status of request
limit
integer
The number of items you asked the list to be limited to.
submitterICA
string
ICA(s) of partner(s) institution(s) who submitted this merchant participation.
requestId
integer
The request ID is obtained by calling POST /merchants/participations API.
httpErrorStatusCode
integer
HTTP error code of original POST /merchants/participations API.
MerchantParticipations
array
List of merchant participation reference objects.
errors
array
Error object which contains a list of error objects.
1 required
errorReason
string
Reason for error.
websiteUrl
string
The URL of the merchant website.
countryCode
string
Legally registered country code of merchant. Refer to (https://www.iso.org/obp/ui/search) for ISO 3166 alpha 3 code values.
Merchants
array
List of Merchant objects
offset
integer
The number of items you asked for at the start of the list to be offset from.
acceptorIds
array
MAID IDs assigned by Mastercard.
dbaNames
array
maids
array
Mastercard Assigned ID (MAID). Adding a MAID based merchant object requires the mandatory provision of maids, while updating a merchant does not necessitate it.
ErrorWrapper
object
The error response object which gets returned in case of any error.
1 property1 required
mids
array
Merchant IDs assigned by the acquirer.
MerchantParticipation
object
Merchant participation reference
14 properties3 required
mid
string
Merchant ID assigned by the acquirer.
dbaName
string
Trade name used by merchant to conduct business and is known to the consumer.
walletMerchantId
string
One or more wallet merchant IDs separated by the pipe symbol.
walletId
integer
Indicates the wallet, 1 for ApplePay, 2 for GooglePay, and 3 for SamsungPay.
Merchant
object
Merchant object
21 properties
requestEndpoint
string
original request endpoint
Errors
object
Error object which returns the list of Error objects.
1 property1 required
searchMaidType
string
Flag to identify provided MAID type. This is mandatory for participation requests with MAID.
merchantLegalName
string
Legally registered name of the merchant.
total
integer
The total number of items in the collection.
optIn
string
Merchant opt-in or opt-out preference for non-merchant negotiated product codes, such as, SPP, SPS, SBJ, and SBK or GCS.
nonMerchantNegotiatedParticipation
string
Merchant opt-in or opt-out preference for non-merchant negotiated product codes, such as, SPP, SPS, SBJ, and SBK.
ErrorList
array
maidType
string
Flag to identify provided MAID type. This is mandatory for participation requests with MAID.
Address
object
The address of the merchant.
6 properties
count
integer
The number of items in this batch (the size of the item array).
wallets
array
Merchant wallets.
walletAcceptance
string
States whether the merchant accepts the wallet or not.
acceptorId
string
Mastercard assigned ID.
maid
string
Mastercard Assigned ID (MAID) as specified in Customer Interface Specification for ISO data element DE48 SE32.
Error
object
Error object which contains details about the Error.
5 properties4 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Mastercard Merchant Participation API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
