How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Mastercard

Mastercard Card API

The Card API from Mastercard — 14 operation(s) for card.

Documentation Provider Profile APIs.io OpenAPI GitHub

Mastercard Card API is one of 249 APIs that Mastercard publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Card. 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 28 operations across 14 paths, and defines 85 schemas. It is described by OpenAPI 2.0, at version 1.0.

Requests are made against the base URL https://api.example.com.

28 operations 14 paths 85 schemas 8 DELETE9 GET7 POST4 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.0
Base URL
https://api.example.com
Contact
Bill Pay Development Support
Resource Areas
1

Paths & Operations 28

Across 14 paths, the API surfaces 28 operations — 8 DELETE, 9 GET, 7 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

Card 28
DELETE
/service-providers/payment-cards/{payment_card_id}
Delete a Payment Card
PaymentCardDeletion 1 param → 202400404
GET
/payment-cards/{payment_card_id}/transaction-footprints
Fetches Historical Transactions and its Transaction Footprints
GetPaymentCardTransactionHistory 5 params → 200400404
POST
/payment-card-enrolments
Batch Registration of Payment Cards (to be deprecated)
BatchRegisterPaymentCards body → 200400404415
POST
/payment-card-deletions
Delete one or more Payment Cards (to be deprecated)
PaymentCardDeletions body → 202400404415
POST
/alerts/merchants/{member_id}/sub-merchants/{sub_merchant_id}/card-acceptor-ids
Mastercard Create Sub-merchant Card Acceptor Id Config.
createAlertsCardAcceptorIdConfig 5 params body → 200400401403404422default
GET
/alerts/merchants/{member_id}/sub-merchants/{sub_merchant_id}/card-acceptor-ids
Mastercard Get Sub-merchant Card Acceptor Id Configs.
getAlertsCardAcceptorIdConfigs 9 params → 200400401403404default
DELETE
/alerts/merchants/{member_id}/sub-merchants/{sub_merchant_id}/card-acceptor-ids
Mastercard Delete Sub-merchant Card Acceptor Id Config.
deleteAlertsCardAcceptorIdConfig 6 params → 200400401403404default
POST
/alerts/merchants/{member_id}/sub-merchants/{sub_merchant_id}/card-acceptor-names
Mastercard Create Sub-merchant Card Acceptor Name Config.
createAlertsCardAcceptorNameConfig 5 params body → 200400401403404422default
GET
/alerts/merchants/{member_id}/sub-merchants/{sub_merchant_id}/card-acceptor-names
Mastercard Get Sub-merchant Card Acceptor Name Configs.
getAlertsCardAcceptorNameConfigs 8 params → 200400401403404default
DELETE
/alerts/merchants/{member_id}/sub-merchants/{sub_merchant_id}/card-acceptor-names
Mastercard Delete Sub-merchant Card Acceptor Name Config.
deleteAlertsCardAcceptorNameConfig 6 params → 200400401403404default
POST
/sub-merchants/{guid}/locations/{location_id}/card-acceptor-names
Mastercard Add Card Acceptor Names
addCardAcceptorNames 5 params body → 200400default
GET
/sub-merchants/{guid}/locations/{location_id}/card-acceptor-names
Mastercard Get Card Acceptor Names
getCardAcceptorNames 10 params → 200400404default
GET
/sub-merchants/{guid}/locations/{location_id}/card-acceptor-names/{id}
Mastercard Get Card Acceptor Name by Id
getCardAcceptorNameById 6 params → 200400404default
PUT
/sub-merchants/{guid}/locations/{location_id}/card-acceptor-names/{id}
Mastercard Update Card Acceptor Name by Id
updateCardAcceptorNameById 7 params body → 200400404default
DELETE
/sub-merchants/{guid}/locations/{location_id}/card-acceptor-names/{id}
Mastercard Delete Existing Card Acceptor Name
deleteCardAcceptorById 6 params → 204400404default
GET
/donors/{donor_id}/cards/{card_id}
Retrieve Card API
retrieveCardUsingGET 5 params → 200400401403500
PUT
/donors/{donor_id}/cards/{card_id}
Update Card API
updateCardUsingPUT 5 params body → 200400401403500
DELETE
/donors/{donor_id}/cards/{card_id}
Delete Card API
deleteCardUsingDELETE 5 params → 204400401403404500
GET
/users/{user_guid}/virtual-card-accounts
Retrieve a list of all virtual cards linked to a user
findVcnCardsByUser 1 param → 200400401403404
POST
/users/{user_guid}/virtual-card-accounts
Register a virtual card linked to a user
createVirtualCardWithControls 1 param body → 201400401403404
GET
/users/{user_guid}/virtual-card-accounts/{account_guid}
Retrieve virtual card account details linked to a user
findVcnCardByUser 2 params → 200400401403404
PUT
/users/{user_guid}/virtual-card-accounts/{account_guid}
Update virtual card account details linked to a user
updateUserCardAndControls 2 params body → 200400401403404
DELETE
/users/{user_guid}/virtual-card-accounts/{account_guid}
Delete a virtual card account linked to a user
deleteUserVirtualCard 2 params → 204400401403404
DELETE
/real-card-accounts/{account_guid}
Delete all virtual cards linked to a real card
DeleteVcnsByRealCardAccountGuid 1 param → 204400401403404
POST
/users/{user_guid}/virtual-card-accounts/{account_guid}/tokens
Register a token linked to a user and a virtual card
TokenCreate 2 params body → 201400401403404
GET
/users/{user_guid}/virtual-card-accounts/{account_guid}/tokens/{token_guid}
Retrieve token details linked to a user and a virtual card
getTokenById 3 params → 200400401403404
PUT
/users/{user_guid}/virtual-card-accounts/{account_guid}/tokens/{token_guid}
Update a token linked to a user and a virtual card
updateTokenById 3 params body → 200400401403404
DELETE
/users/{user_guid}/virtual-card-accounts/{account_guid}/tokens/{token_guid}
Delete a token linked to a user and a virtual card
deleteTokenById 3 params → 204400401403404

Schemas 85

The contract defines 85 schemas that model the data the API accepts and returns. The most detailed are TransactionMetadata (14 properties), Control (12 properties), DonateCardRetrieve (10 properties), VelocityControl (8 properties). Each schema is shown below with its type and property counts.

TransactionId
string
A unique ID associated with a payment transaction, For example, original payment transaction ID. The same ID will be returned in the response corresponding to…
X-MC-Correlation-ID
string
PaymentCard
object
The request object for registering a new Payment Card. This object will be encrypted before sending it to the server.
2 properties 2 required
PaymentCardEnrolment
object
The response object which contains Payment Card information.
5 properties
TransactionMetadata
object
Metadata about a transaction.
14 properties 10 required
PaymentCardId
string
Unique ID provided in the response while registering a payment card.
ErrorWrapper
object
The error response object gets returned in case of any error.
1 property 1 required
HistoricalTransactionFootprint
object
A single transaction footprint along with transaction info for a corresponding payment transaction.
2 properties 2 required
TransactionFootprint
object
A single transaction footprint calculated for a corresponding payment transaction.
2 required
Category
object
User understandable information about an MCC categorization.
4 properties
HistoricalTransactionFootprints
object
Response object which holds all the transaction footprints for historical transactions.
5 properties
CarbonUsage
object
Object to hold carbon usage data.
2 properties
Errors
object
Error object which returns a list of Error objects.
1 property 1 required
ErrorList
array
Day
string
PaymentCardEnrolments
array
List of payment card enrolments corresponding to each of the payment cards. This information should be used to identify the success and failure enrolments and…
CurrencyCode
string
Currency code as per ISO 4217
Error
object
Error object which contains details about the error.
5 properties 4 required
AlertsCardAcceptorNameConfig
object
Card acceptor name configuration
5 properties 1 required
AcquirerReferenceId
string
The acquirer BINs that a partner currently services under their portfolio. This is represented by Mastercard DE 31 - Subfield 2 (Clearing), DE 32 (Authorizatio…
ResourceId
string
Unique identifier of resource
CardAcceptor
string
Merchant Card Acceptor
CardAcceptorDataResource
object
4 properties 4 required
CardAcceptorData
object
2 properties 2 required
PageableCardAcceptorNamesResource
object
Pageable card acceptor names resource with pagination metadata
2 properties
CardAcceptorRegion
string
A sub-element of the merchant descriptor indicating either the state, province, or region of the merchant as it appears on the cardholder's statement. Value is…
AlertsCardAcceptorIdConfig
object
Map of acquirer reference id and the corresponding card acceptor id
3 properties 2 required
LastName
string
The individual's last name
ResponseTime
string
Total response time in ms
AlertsMerchantConfigId
string
Internal Universally Unique Identifier (UUID) which uniquely identifies the merchants configuration
ErrorResponse
object
Error Response object
1 property 1 required
Etag
string
Etag is a response header which is an identifier for a specific version of a resource.
AlertsMerchantIdentifierConfigIdOnly
object
Merchant identifier configuration Id (referring to card acceptor id or name configuration)
1 property
MerchantGuid
string
Consumer Clarity internal merchant's GUID
BulkOperationResource
object
Resource with responseCode and details
3 properties 1 required
Errors_2
object
Errors object
1 property 1 required
CardAcceptorCountry
string
A sub-element of the merchant descriptor indicating the country of the merchant as it appears on the cardholder's statement. Value is not case-sensitive and ca…
UserId
string
The user id of the submitter/technical contact.
ClarityResponseHeader
AlertsMerchantMemberId
string
Internal Universally Unique Identifier (UUID) which uniquely identifies the merchants
CardAcceptorName
string
A sub-element of the merchant descriptor that contains the merchant's name or doing business as name as it appears on the cardholder's billing statement.
FirstName
string
The individual's first name
AlertsCardAcceptorNameConfigs
object
Card acceptor name configurations for a merchant
2 properties
CardAcceptorCity
string
A sub-element of the merchant descriptor indicating the merchant city/location as it appears on the cardholder's billing statement.
CardAcceptorNamesBulkResource
object
Set of Card Acceptor Names resource
1 property
CardAcceptorId
string
Identifies the card acceptor ID assigned by the acquirer. This ID must represent a unique identifier for each merchant name/location within the acquirer BIN. T…
ResponseHeader
object
4 properties
AlertsCardAcceptorIdConfigs
object
Card acceptor id configurations for a merchant
2 properties
CardAcceptorNamesBulk
object
1 property 1 required
Error_2
object
Error object
5 properties
UpdateCard
object
6 properties 4 required
DonateCardUpdate
object
2 properties
Error-401
object
1 property 1 required
Error-403
object
1 property 1 required
cardExpiry
object
2 properties
Error-404
object
1 property 1 required
CardBillingAddress
object
7 properties
DonateCardRetrieve
object
10 properties
Error-500
object
1 property 1 required
Error_3
object
1 property 1 required
VelocityControl
object
The VelocityControl can limit the frequency, and the total cumulative amount of authorizations performed on the cardholders account within a specified time per…
8 properties 2 required
CurfewControl
object
Curfew Control
5 properties 4 required
Vcn
Token
object
4 properties
TransactionLimitControl
object
The TransactionLimit control provides the ability to limit individual transaction authorizations to a maximum amount
2 properties 2 required
VirtualCardAccount
object
2 required
UpdateVirtualCardAccount
object
1 required
MerchantIdControl
object
The Merchant ID control provides the ability to limit authorizations to particular merchants
3 properties 3 required
ResourceIdentifier
string
A UUID which uniquely identifies a resource
ValidityPeriodControl
object
The ValidityPeriod control provides the ability to limit authorization activity to a defined time period
4 properties 3 required
MccControl
object
The Card Acceptor Business Codes (MCC) control can control the type of purchases for which a card is used
2 properties 2 required
Controls
array
In Control Card Controls
Card
object
2 properties 2 required
ErrorWrapper_2
object
1 property 1 required
AgeingVelocityControl
object
The AgingVelocityControl provides the requester with the ability to set a notional credit line through the CumulativeControl. This control keeps track of the c…
7 properties 4 required
AmountRangeControl
object
The exact amount range control will approve a transaction only if the requested amount is equal or greater than MinAmount and less than or equal to MaxAmount.…
6 properties 4 required
VcnUserDetail
object
3 properties 3 required
UpdateVCN
object
2 properties
TokenUpdate
object
1 property
TimeOfDayControl
object
The TimeOfDayControl provides the ability to limit authorization activity to defined time periods for each day
3 properties 3 required
Errors_3
object
1 property 1 required
Control
object
In Control Rule
12 properties 2 required
GeographyControl
object
The GeographicControl provides the ability to control where a card is physically used
2 properties 2 required
TimeOfDay
object
3 properties 3 required
Error_4
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mastercard-card-api-openapi.yml Raw ↑

Other APIs Mastercard publishes across the network.

Mastercard Universal Specification Submission API
AE Profile APIs.io
Mastercard Account to Account Commerce for Creditor Service Providers
AE Profile APIs.io
Mastercard Debtor Service Provider Resources API
AE Profile APIs.io
Mastercard Automatic Billing Updater API
AE Profile APIs.io
Mastercard Benefit Eligibility Service API
AE Profile APIs.io
Mastercard Bill Pay API
AE Profile APIs.io
Mastercard Bill Payment Validator
AE Profile APIs.io
Mastercard BIN Lookup API
AE Profile APIs.io
Mastercard Business Payment Controls
AE Profile APIs.io
Mastercard Carbon Calculator API
AE Profile APIs.io
Mastercard Carbon Calculator Experience API
AE Profile APIs.io
Mastercard Checkout Solutions
AE Profile APIs.io
#Card
← Back to M APIs
API Details
ID
mastercard:mastercard-card-api
Base URL
https://api.example.com
Docs
https://developer.mastercard.com/product/account-services-catalogue/
Provider
Mastercard
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

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.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=mastercard-card-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/mastercard-card-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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 Card 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.