Mastercard Apis API

swagger: '2.0'
info:
  title: Mastercard Bill Payment Validator Account Opening Apis API
  description: This service is provided on behalf of the Mastercard Remote Payment and Presentment (RPPS) Bill Payment Processing Network, which supports consumer to business "push" bill payments (i.e. those which are not funded by debit/credit card transactions) in the U.S.
  version: '1.0'
  x-artifactId: billpay-api
  contact:
    name: Bill Pay Development Support
    email: Bill_Pay_Development_Support@mastercard.com
host: sandbox.api.mastercard.com
basePath: /billpayAPI/v1
schemes:
- https
consumes:
- application/json
produces:
- application/json
tags:
- name: Apis
paths:
  /api/orders:
    post:
      tags:
      - Apis
      summary: Searches order details based on the search criteria
      description: Search for orders based on transaction fields that you currently support
      operationId: getTransactionDetails
      parameters:
      - $ref: '#/components/parameters/eth_date'
      - $ref: '#/components/parameters/authorization'
      requestBody:
        $ref: '#/components/requestBodies/OrderApi'
      responses:
        '200':
          $ref: '#/components/responses/OrderApiAcknowledgement'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '405':
          $ref: '#/components/responses/MethodNotAllowed'
  /api/orders/healthchecks:
    get:
      tags:
      - Apis
      operationId: getHealthDetails
      description: Health or Echo or Heartbeat endpoint ensuring that the API is running
      summary: Health endpoint to ensure confirm connectivity to transaction API
      responses:
        '200':
          $ref: '#/components/responses/HealthCheckResponse'
components:
  schemas:
    RequestReference:
      title: Request References
      description: Request Information details, such as tracking details
      type: object
      properties:
        originatorChannel:
          title: Original Requester Channel
          type: string
          minLength: 1
          maxLength: 20
          description: "Example value :\n  - DIGITAL\n  - CALL_CENTRE\n  - FIRST_PARTY_TRUST\n"
          example: DIGITAL
        originatorId:
          title: Requester ID
          type: string
          minLength: 1
          maxLength: 100
          description: Hashed Requesters/Aggregator Issuer ID
          example: 420f0845bd9b808abd7acc053b0b372ceb461edd584e9b9db02b35304255715f
        sourceId:
          title: Source ID
          type: string
          minLength: 1
          maxLength: 100
          description: Aggregator's Actual Issuer ID Hashed
          example: 66666688ggg0845bd9b808abd7acc053b0b372ceb461edd584e9b9db02b324gf
        originatorDescription:
          title: Requester Description
          type: string
          minLength: 1
          maxLength: 100
          description: Description about the issuer
          example: Test Issuer
        correlationId:
          title: Correlation Id
          description: Correlation ID between Ethoca and merchant tracking
          type: string
          minLength: 1
          maxLength: 201
          example: zebj8evpeo
        locale:
          type: string
          minLength: 5
          maxLength: 5
          description: 'The locale, or language-country combination, associated with the caller of the service in ISO 639-1 and ISO-3166-1 format

            - ''en-US''

            - ''en-CA''

            - ''en-GB''

            - ''es-ES''

            - ''es-MX''

            - ''es-US''

            - ''fr-CA''

            - ''fr-FR''

            - ''pt-BR''

            - ''pt-PT''

            - ''he-IL''

            '
          example: en-US
    Payment:
      type: object
      properties:
        id:
          minLength: 1
          maxLength: 100
          type: string
          description: Payment object unique identifier (merchant generated sequence-based ID for each payment, for example 1, 2, 3, 4...)
          example: '3'
        matchedPayment:
          type: boolean
          description: Indicates whether a payment record matches the transaction search attributes
          example: true
        paymentType:
          $ref: '#/components/schemas/PaymentType'
        cardFirstSix:
          minLength: 6
          maxLength: 6
          type: string
          description: The first six digits of the card number associated with the transaction. Format - exactly six numeric characters.
          example: '524167'
        cardLastFour:
          $ref: '#/components/schemas/CardLastFour'
        cardCvv2ValidationOutcomeAtPurchase:
          type: string
          minLength: 1
          maxLength: 1
          pattern: ^[A-Za-z0-9]{1,1}$
          description: "Card CVV2 verification code received at the purchase\n\nAllowed values:\n  - X\n  - U\n  - P\n  - Y\n  - D\n  - N\n\nDefinition of allowed values:\n  - X: No information available\n  - U: The issuer has not certified or has not provided the encryption keys\n  - P: Card verification not performed\n  - Y: Valid\n  - D: Invalid\n  - N: Not attempted\n"
          example: X
        addressValidationServiceMatch:
          type: string
          minLength: 1
          maxLength: 1
          description: "Indicates whether the billing address was validated with an AVS service\n\nAllowed values:\n  - Y\n  - N\n  - U\n\nDefinition of allowed values:\n  - Y: Yes\n  - N: No\n  - U: Unavailable\n"
          example: Y
        totalBeforeTax:
          description: Subtotal (before tax). Maximum number of fractional digits supported is 2.
          type: string
          minLength: 1
          maxLength: 12
          example: '898.96'
        paymentAmount:
          type: string
          minLength: 1
          maxLength: 12
          description: Total amount of this payment. Maximum number of fractional digits supported is 2.
          example: '250.35'
        transactionIdentifierValue:
          minLength: 1
          maxLength: 30
          type: string
          description: The TransactionId for this order; for Mastercard purchases, this is field DE63, and for Visa this is Tran ID or Tran ID1.
          example: 90989JJJNM7767
        acquirerReferenceNumber:
          minLength: 23
          maxLength: 23
          type: string
          description: Display of the Acquirer Reference Number for this order
          example: '12345678901234567890123'
        issuerAuthorizationCode:
          minLength: 6
          maxLength: 6
          type: string
          description: Pre-authorization code returned by the processor
          example: 89ii88
        authorizationDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: Display of the Authorization date (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        transactionType:
          type: string
          minLength: 4
          maxLength: 10
          description: "Type of payment transaction\n\nAllowed values:\n  - Adjustment\n  - Credit\n  - Reversal\n  - Sale\n"
          example: Credit
        merchantIdentificationNumber:
          minLength: 1
          maxLength: 50
          type: string
          description: Merchant Identification Number (MID). Assigned by acquirer.
          example: GOOG9898K87
        paymentGatewayId:
          minLength: 1
          maxLength: 10
          type: string
          description: This is passed as part of the transaction. Key for merchants with more than one gateway.
          example: CH8989V01
        paymentGatewayDescriptor:
          minLength: 1
          maxLength: 50
          type: string
          description: The descriptor for the payment gateway
          example: Channel 89 version 1 gateway.
        merchantBillingDescriptor:
          minLength: 1
          maxLength: 24
          type: string
          description: The settled descriptor that shows on the credit card holder's statement at settlement
          example: Google Storage.
        authorizedMerchantBillingDescriptor:
          minLength: 1
          maxLength: 24
          type: string
          description: The pre-settlement authorized descriptor that shows on the website or app being used by the credit card holder
          example: Subscription renewal
        billingName:
          $ref: '#/components/schemas/NameType'
        billingAddress:
          $ref: '#/components/schemas/AddressType'
      description: List of payments for the order (requires at least one, may repeat)
    OrderApi:
      type: object
      required:
      - requestReference
      - searchCriteria
      properties:
        requestReference:
          $ref: '#/components/schemas/RequestReference'
        searchCriteria:
          $ref: '#/components/schemas/SearchCriteria'
    MerchantReceiptContact:
      type: object
      properties:
        phoneForReceipt:
          minLength: 3
          maxLength: 30
          type: string
          description: Merchant's primary phone (such as the sales number shown on receipt) include the country code and any applicable separators
          example: +1-234-567-8901
        emailForReceipt:
          minLength: 1
          maxLength: 200
          type: string
          description: Merchant's sales email (such as the sales email shown on receipt)
          example: sales.merchant@example.com
        websiteForReceipt:
          minLength: 1
          maxLength: 100
          type: string
          description: URL for merchant's orders (such as the website address shown on receipt)
          example: http://merchantwebsite.example.com
        receiptAddress:
          $ref: '#/components/schemas/AddressType'
    Loyalty:
      type: object
      properties:
        id:
          minLength: 1
          maxLength: 100
          type: string
          description: Loyalty unique identifier  (merchant generated sequence-based ID for each loyalty account, for example 1, 2, 3, 4...)
          example: '123'
        programName:
          minLength: 1
          maxLength: 200
          type: string
          description: Name of the loyalty program
          example: GoldClub
        numberRegistered:
          minLength: 1
          maxLength: 20
          type: string
          description: Loyalty program number assigned to registered account
          example: '7678767'
        nameRegistered:
          $ref: '#/components/schemas/NameType'
        addressRegistered:
          $ref: '#/components/schemas/AddressType'
      description: List of loyalty membership accounts that relate to the order
    OrderApiAcknowledgement:
      type: object
      required:
      - responseStatus
      properties:
        responseStatus:
          $ref: '#/components/schemas/ResponseStatus'
        order:
          $ref: '#/components/schemas/Order'
        merchantProfile:
          $ref: '#/components/schemas/MerchantProfile'
        paymentFacilitatorProfile:
          $ref: '#/components/schemas/MerchantProfile'
        facilitatorProfile:
          $ref: '#/components/schemas/FacilitatorProfile'
        accountProfile:
          $ref: '#/components/schemas/AccountProfile'
    VehicleRental:
      type: object
      description: List of rental vehicle reservations
      required:
      - rentalCompanyName
      - confirmationNumber
      - vehicleType
      - pickupDateTime
      - pickupLocation
      properties:
        rentalCompanyName:
          minLength: 1
          maxLength: 100
          type: string
          description: Vehicle rental company name
          example: Enterprise Rentals
        confirmationNumber:
          minLength: 1
          maxLength: 50
          type: string
          description: The confirmation number at the  rental agency
          example: XT5654T
        loyaltyReferenceId:
          type: string
          minLength: 1
          maxLength: 100
          description: 'Reference to loyalty object (in: /loyalty.id)'
          example: YU7676K
        vehicleRentalPrice:
          type: string
          minLength: 1
          maxLength: 12
          example: '45.99'
          description: The cost of the daily rate for a vehicle rental
        vehicleType:
          minLength: 1
          maxLength: 20
          type: string
          description: Rental vehicle type
          example: Full size
        pickupDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: Rental vehicle pick up date and time (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        pickupTimezone:
          type: string
          minLength: 1
          maxLength: 50
          description: The timezone for the pickup location of the vehicle as it appears in the TZ database
          example: Europe/Istanbul
        actualPickupDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: The actual pick up date and time (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        pickupLocation:
          minLength: 1
          maxLength: 200
          type: string
          description: Rental vehicle pick up location
          example: Toronto West
        dropoffDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: Rental vehicle drop-off date and time (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        dropoffTimezone:
          type: string
          minLength: 1
          maxLength: 50
          description: The timezone for the drop off location of the vehicle as it appears in the TZ database
          example: Asia/Muscat
        actualDropoffDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: The actual drop-off date and time (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        dropoffLocation:
          minLength: 1
          maxLength: 200
          type: string
          description: Rental vehicle drop off location
          example: Toronto West
        driverLicenseNumberLast3:
          minLength: 3
          maxLength: 3
          type: string
          description: The last 3 digits of the Driver's license number
          example: '963'
        driverLicenseIssuer:
          minLength: 1
          maxLength: 25
          type: string
          description: The state or country that the Driver's license was issued in
          example: Ontario
        driverLicenseExpiryDate:
          description: Driver's license expiry data (String based date/time representation in International Date Format (ISO 8601) YYYY-MM-DD)
          type: string
          format: date
          minLength: 10
          maxLength: 10
          example: '2017-06-19'
        operatorName:
          $ref: '#/components/schemas/NameType'
        relatedPurchases:
          type: array
          items:
            $ref: '#/components/schemas/RelatedPurchase'
        vehiclePickupAddress:
          $ref: '#/components/schemas/AddressType'
        vehicleDropoffAddress:
          $ref: '#/components/schemas/AddressType'
    Delivery:
      type: object
      description: List of deliveries created for the order
      properties:
        id:
          minLength: 1
          maxLength: 100
          type: string
          description: Unique identifier for delivery item (merchant generated sequence-based ID for each delivery, for example 1, 2, 3, 4...)
          example: '32'
        digitalDelivery:
          $ref: '#/components/schemas/DigitalDelivery'
        physicalDelivery:
          $ref: '#/components/schemas/PhysicalDelivery'
    Lodging:
      type: object
      required:
      - lodgingCompanyName
      - confirmationNumber
      - stayDuration
      - roomsBooked
      - checkInDateTime
      - checkoutDateTime
      properties:
        lodgingCompanyName:
          minLength: 1
          maxLength: 100
          type: string
          description: The name of the property
          example: Mantle Lodging and Hotels
        confirmationNumber:
          minLength: 1
          maxLength: 50
          type: string
          description: The confirmation number at the property
          example: CT67Y01
        roomType:
          minLength: 1
          maxLength: 20
          type: string
          description: The type of room booked
          example: Suite
        stayDuration:
          type: integer
          minimum: 0
          maximum: 99999
          description: The room stay duration (in days)
          format: int32
          example: 15
        roomsBooked:
          type: integer
          minimum: 0
          maximum: 99999
          description: The number of rooms that were booked
          format: int32
          example: 1
        lodgingPrice:
          type: string
          minLength: 1
          maxLength: 12
          example: '199.99'
          description: The cost of a nightly rate for a lodging rental. If there are multiple prices over different nights, you may use an average.
        checkInDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: The date and time the guest will check in to the property (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        lodgingTimezone:
          type: string
          minLength: 1
          maxLength: 50
          description: The timezone of the lodging's location. This is not the timezone of the property's corporate office, but rather the specific location of the property that is being booked as it appears in the TZ database.
          example: America/New_York
        actualCheckInDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: The actual date and time the guest checked in to the property (String based date time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        checkoutDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: The date and time the guest will check out of the property (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        actualCheckOutDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: The actual date and time the guest checked out of the property (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        roomPreferences:
          minLength: 1
          maxLength: 200
          type: string
          description: Request preferences for the room
          example: High speed WiFi required
        loyaltyReferenceId:
          type: string
          minLength: 1
          maxLength: 100
          description: 'Reference to loyalty object (in: /loyalty.id)'
          example: RT6545E01
        relatedPurchases:
          type: array
          description: Additional charges related to the property stay (such as restaurant charges, mini-bar, etc.)
          items:
            $ref: '#/components/schemas/RelatedPurchase'
        lodgingAddress:
          $ref: '#/components/schemas/AddressType'
      description: List of accommodation rentals
    ResponseStatus:
      title: Response Status
      required:
      - code
      type: object
      properties:
        code:
          title: Code
          type: string
          minLength: 17
          maxLength: 27
          description: "API status code, not an HTTP status code\n\nAllowed values:\n  - TRANSACTION_FOUND\n  - TRANSACTION_NOT_FOUND\n  - MULTIPLE_TRANSACTIONS_FOUND\n"
          example: TRANSACTION_FOUND
        message:
          title: Message
          minLength: 1
          maxLength: 100
          type: string
          description: API status message, not an HTTP status message
          example: Transaction details provided
        trackingId:
          title: Tracking Id
          description: Any internal merchant reference ID linked to this search
          type: string
          minLength: 1
          maxLength: 201
          example: zebj8evpeo
      description: Result status of the request
    RelatedPurchase:
      type: object
      description: Additional charges related to the property stay (such as restaurant charges, mini-bar, etc.)
      properties:
        id:
          minLength: 1
          maxLength: 100
          type: string
          description: Related purchases unique identifier (merchant generated sequence-based ID for each reservation, for example 1, 2, 3, 4...)
          example: '8987'
        productName:
          minLength: 1
          maxLength: 100
          type: string
          description: Description of what was purchased
          example: flower bouquet
        quantity:
          description: Quantity of items purchased (1, 3, 30 etc.)
          type: string
          minLength: 1
          maxLength: 100
          example: '2'
        unitOfMeasurement:
          description: The unit of measurement for the product purchased (i.e. weight of a product)
          type: string
          minLength: 1
          maxLength: 100
          example: kg
        productPrice:
          type: string
          minLength: 1
          maxLength: 12
          description: Price per unit (maximum number of fractional digits supported is 2)
          example: '29'
        purchaseDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: The date and time that the purchase was made (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        purchaseLocation:
          minLength: 1
          maxLength: 25
          type: string
          description: Source of the related purchase, and not the initial purchase (such as website, mobile, ticket counter, etc.)
          example: In-Store
    SearchCriteria:
      title: Search Criteria for order lookup
      description: Parameters used to look up order
      type: object
      properties:
        paymentType:
          title: Transaction Card Type
          type: string
          minLength: 2
          maxLength: 8
          description: "The card brand or network as provided by the issuer\n\nAllowed values:\n  - AMEX\n  - DISCOVER\n  - MC\n  - VISA\n\nDefinition of allowed values:\n  - AMEX: American Express\n  - DISCOVER: Discover\n  - MC: Mastercard\n  - VISA: Visa\n"
          example: MC
        transactionIdentifierType:
          type: string
          minLength: 1
          maxLength: 20
          description: "Payment type-specific transaction identifier type associated with the value specified in transactionIdentifierValue.\n\nCurrent values:\n  - BANKNET_REF_NUM\n  - INVOICE_REF_NUM\n\nDefinition of current values:\n- Mastercard: DE 63, Subfield 2: Banknet Reference Number\n- American Express: TAB Field 26: Invoice/Reference Number\n"
          example: BANKNET_REF_NUM
        transactionIdentifierValue:
          title: Transaction Identifier Value
          type: string
          minLength: 1
          maxLength: 30
          description: Transaction identifier value associated with the type specified in transactionIdentifierType
          example: T123456
        acquirerReferenceNumber:
          title: Acquirer Reference Number (ARN)
          minLength: 23
          maxLength: 23
          type: string
          description: Acquirer Reference Number of the transaction
          example: '12345678901234567890123'
        transactionDateTime:
          title: Transaction Date and/or Time
          minLength: 10
          maxLength: 25
          type: string
          description: "Date, time, and time zone of the authorization of the transaction \n(for example, \"2020-06-18T17:11:05-05:00\"), OR Date and time of the \ntransaction in Coordinated Universal Time (UTC) (for example, \n\"2020-06-18T17:11:05+00:00\"), OR If time or time zone is unknown, \nthen date of the transaction (for example, \"2020-06-18\"). ISO 8601 \nformat. This is the date and time of the authorization of the \ntransaction, not the date and time of the settlement of the transaction.\n"
          example: '2020-06-18T17:11:05-05:00'
        cardFirstSix:
          title: Card First Six
          minLength: 6
          maxLength: 6
          type: string
          pattern: ^\d{6}$
          description: First six characters of the card used in the transaction
          example: '123456'
        cardLastFour:
          title: Card Last Four
          minLength: 4
          maxLength: 4
          type: string
          pattern: ^\d{4}$
          description: Last four characters of the card used in the transaction
          example: '1234'
        issuerAuthorizationCode:
          title: Issuer Authorization Code
          maxLength: 6
          minLength: 6
          type: string
          description: Issuer authorization code for the transaction
          example: '123456'
        transactionAmount:
          title: Transaction Value
          minLength: 1
          maxLength: 12
          type: string
          description: 'Total amount value associated with the transaction.

            <br/><br/>Decimal point period is expected to denote separation of the fractional suffix

            from the rest of the amount, if applicable for the currency. Decimal

            point period must not be the first character. Examples:<br>- USD exponent

            is 2, so $250 USD value should be represented as 250.00, 34&cent; USD

            value should be represented as 0.34<br>- JPY exponent is 0, so &yen;250

            JPY value should be represented as 250

            '
          example: '250.35'
        transactionCurrencyCode:
          title: Transaction Currency Code
          maxLength: 3
          minLength: 3
          type: string
          description: Alphabetic currency code associated with the value in ISO 4217 format
          example: USD
        merchantId:
          title: Merchant Identifier
          description: The alphanumeric ID of the sub-merchant associated with the purchase details. Required for channel partner
          type: string
          minLength: 1
          maxLength: 100
          example: GHF5F67DFSD468GJJXH78
        cardAcceptorId:
          title: Card Acceptor Id
          description: An identifier for the store location or transaction point. Also known as  Card Acceptor ID and it is assigned by the merchant acquirer.
          type: string
          minLength: 1
          maxLength: 15
          example: 12345671234567
        cardAcceptorName:
          title: Card Acceptor Name
          description: 'Merchant ''doing business as'' name, or website name<br>- Mastercard: DE 43, Subfield 1; Card Acceptor Name<br>- Visa: TC 05, positions 92-116; Merchant Name'
          type: string
          minLength: 1
          maxLength: 50
          example: MicrosoftXBox
        cardAcceptorLocation:
          title: Card Acceptor Location
          description: 'Merchant city, telephone number, email address, or URL<br>- Mastercard: DE 43, Subfield 3: Card Acceptor City<br>- Visa: TC 05, positions 117-129: Merchant City'
          type: string
          minLength: 1
          maxLength: 50
          example: Austin
        cardAcceptorRegionCode:
          title: CardAcceptor Region Code
          description: The abbreviation for a subdivision (State, Province, Parish, Territory, etc.) provided in the ISO 639-1 and ISO-3166-2 format
          type: string
          minLength: 1
          maxLength: 3
          pattern: ^[A-Za-z0-9]*$
          example: TX
        cardAcceptorCountryCode:
          title: CardAcceptor Country Code
          description: The Country Code associated with the cardAcceptorNames location data.
          type: string
          minLength: 2
          maxLength: 3
          example: US
    AirTravel:
      type: object
      description: List of air travel reservations
      required:
      - id
      - passengerNameRecord
      - designatorCode
      - flightNumber
      - originAirportCode
      - destinationAirportCode
      properties:
        id:
          minLength: 1
          maxLength: 100
          type: string
          description: AirTravel unique identifier (merchant generated sequence-based ID for each reservation, for example 1, 2, 3, 4...)
          example: 1
        passengerNameRecord:
          minLength: 1
          maxLength: 6
          type: string
          description: The Passenger Name Record or Record Locator for the reservation
          example: XY8UI9
        designatorCode:
          minLength: 2
          maxLength: 2
          type: string
          description: The two digit IATA airline code
          example: AI
        airlineName:
          type: string
          minLength: 1
          maxLength: 100
          description: The full name of the airline
          example: Paradise Island Airlines
        flightNumber:
          minLength: 1
          maxLength: 10
          type: string
          description: The flight number assigned to that travel leg, not the full flight designator
          example: '8788'
        flightPrice:
          minLength: 1
          maxLength: 12
          type: string
          description: The cost of a single flight on the itinerary
          example: '245.99'
        originAirportCode:
          minLength: 3
          maxLength: 3
          type: string
          description: The 3 digit IATA code for the originating airport
          example: LAX
        originAirportName:
          type: string
          minLength: 1
          maxLength: 200
          description: The full name of the originating airport
          example: Metropolis International Airport
        destinationAirportCode:
          minLength: 3
          maxLength: 3
          type: string
          description: The 3 digit IATA code for the destination airport
          example: ISL
        destinationAirportName:
          type: string
          minLength: 1
          maxLength: 200
          description: The full name of the destination airport
          example: Smallville Regional Airport
        scheduledDepartureDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: The scheduled time of departure (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        departureTimezone:
          type: string
          minLength: 1
          maxLength: 50
          description: The timezone of the departure as it appears in the TZ database
          example: Europe/Paris
        actualDepartureDateTime:
          minLength: 20
          maxLength: 20
          type: string
          description: The actual time of departure (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        scheduledArrivalDateTime:
          type: string
          minLength: 20
          maxLength: 20
          description: The scheduled time of arrival (String based date/time representation in International Date Time Format (ISO 8601) in UTC - yyyy-mm-ddThh:mm:ssZ)
          format: date-time
          example: '2017-06-19T13:18:18Z'
        arrivalTimezone:
          type: string

# --- truncated at 32 KB (100 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mastercard/refs/heads/main/openapi/mastercard-apis-api-openapi.yml