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

Mastercard Orders API

The Orders API from Mastercard — 3 operation(s) for orders.

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

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

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

3 operations 3 paths 51 schemas 1 GET2 POST

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
Resource Areas
1

Paths & Operations 3

Across 3 paths, the API surfaces 3 operations — 1 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Orders 3
POST
/api/orders
Searches order details based on the search criteria
getTransactionDetails 2 params body → 200400401403405
GET
/api/orders/healthchecks
Health endpoint to ensure confirm connectivity to transaction API
getHealthDetails → 200
POST
/vendors/{vendor_id}/orders/status
API used by external Vendors to provide the orders status
updateOrderStatus 1 param body → 200400401

Schemas 51

The contract defines 51 schemas that model the data the API accepts and returns. The most detailed are Recurring (33 properties), Order (31 properties), AccountProfile (29 properties), PhysicalDelivery (24 properties). Each schema is shown below with its type and property counts.

RequestReference
object
Request Information details, such as tracking details
6 properties
Payment
object
List of payments for the order (requires at least one, may repeat)
21 properties
OrderApi
object
2 properties 2 required
MerchantReceiptContact
object
4 properties
Loyalty
object
List of loyalty membership accounts that relate to the order
5 properties
OrderApiAcknowledgement
object
6 properties 1 required
VehicleRental
object
List of rental vehicle reservations
20 properties 5 required
Delivery
object
List of deliveries created for the order
3 properties
Lodging
object
List of accommodation rentals
15 properties 6 required
ResponseStatus
object
Result status of the request
3 properties 1 required
RelatedPurchase
object
Additional charges related to the property stay (such as restaurant charges, mini-bar, etc.)
7 properties
SearchCriteria
object
Parameters used to look up order
16 properties
AirTravel
object
List of air travel reservations
21 properties 6 required
Discount
object
List of discounts applied to the order
3 properties 3 required
Tax
object
3 properties 3 required
Passenger
object
The list of passengers flying on this particular flight
9 properties
DigitalDelivery
object
7 properties
Reservation
object
List of reservations created for the order
12 properties 4 required
ErrorResponse
object
Error response object
1 property 1 required
CustomData
object
2 properties
CardLastFour
string
Last four characters of the card used in the transaction
NameType
object
5 properties
CallToActionLink
object
2 properties 2 required
FacilitatorProfile
object
2 properties
CreditReimbursement
object
List of credits for the order
10 properties 2 required
TransactionDetails
object
Details about the order transaction aspects
14 properties
HealthCheckResponse
string
The code indicates if the API is up or not - OK = The API is up and running - failure = The API is down
HistoricOrder
object
List of historic orders for this account.
14 properties
Refund
object
List of refunds made for the order
8 properties 3 required
Consequence
object
2 properties
PaymentType
string
The card brand or network as provided by the issuer Allowed values: - AMEX - DISCOVER - MC - VISA Definition of allowed values: - AMEX: American Express - DISC…
Usage
object
Item (product) usage details
5 properties
AccountProfile
object
29 properties
PhysicalDelivery
object
24 properties
MerchantProfile
object
15 properties
Errors
object
Errors object
1 property 1 required
OrderItem
object
List of items (products) included in the order (requires at least one, may repeat). This item identified one product of the list.
21 properties 3 required
Order
object
Contains items, payments, transaction details, shipping, and other information related to the order (purchase)
31 properties 6 required
MerchantCustomerServiceContact
object
5 properties
AddressType
object
9 properties
Recurring
object
Recurring product details
33 properties
CurrencyCode
string
Currency code applied to order. This currency will apply to all amount/price fields throughout entire payload. Must be three character ISO currency code (https…
Error
object
Error object
5 properties 1 required
OrderItemStatus
object
7 properties
Errors_2
object
1 property 1 required
History
object
4 properties
ErrorItem
object
Error Details
5 properties
ErrorsWrapper
object
1 property 1 required
OrderStatus
object
4 properties
OrderItemError
object
3 properties
OrderStatusArray
array
order status array list

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mastercard-orders-api-openapi.yml Raw ↑

Other APIs Mastercard publishes across the network.

Mastercard Universal Specification Submission API
Mastercard Account to Account Commerce for Creditor Service Providers
Mastercard Debtor Service Provider Resources API
Mastercard Automatic Billing Updater API
Mastercard Benefit Eligibility Service API
Mastercard Bill Pay API
Mastercard Bill Payment Validator
Mastercard BIN Lookup API
Mastercard Business Payment Controls
Mastercard Carbon Calculator API
Mastercard Carbon Calculator Experience API
Mastercard Checkout Solutions
Where this information came from

This is an independent, third-party profile of Mastercard Orders 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.