Oracle Hospitality Credit Card API

openapi: 3.2.0
info:
  title: OPERA Cloud Front Desk Configuration Credit Card API
  description: APIs to cater for Front Desk Configuration in OPERA Cloud. Here you can find operations to get, post, put and delete front desk codes such as commission codes, transaction groups, codes & subgroups, articles, payment methods and credit card types.<br /><br />Compatible with OPERA Cloud release 26.2.0.0.<br /><br /><p>This document and all content within is available under the Universal Permissive License v 1.0 (https://oss.oracle.com/licenses/upl). Copyright (c) 2020,2023 Oracle and/or its affiliates.</p><br /><br /> Compatible with OPERA Cloud release 20.99.99.99.<br /><br /><p> This document and all content within is available under the Universal Permissive License v 1.0 (https://oss.oracle.com/licenses/upl). Copyright (c) 2020, 2026 Oracle and/or its affiliates.</p>
  version: 26.2.0.0
  termsOfService: https://www.oracle.com/legal/terms.html
  contact:
    email: hospitality_apis_ww_grp@oracle.com
  license:
    name: UPL
    url: https://opensource.org/licenses/upl
servers:
- url: /fof/config/v1
tags:
- name: CreditCard
  description: The Credit Card Internal Service contains operations used internally by OPERA Cloud.
paths:
  /authorizationRule:
    get:
      summary: Operation to fetch AuthorizationRule.
      description: ' <p><strong>OperationId:</strong>getAuthorizationRule</p>'
      operationId: getAuthorizationRule
      parameters:
      - name: hotelId
        in: query
        required: false
        description: The hotel code to retrieve authorization rules for.
        schema:
          type: string
      - name: reservationId
        in: query
        required: false
        description: A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.
        schema:
          type: string
      - name: idExtension
        in: query
        required: false
        description: Additional identifying value assigned by the creating system.
        schema:
          type: integer
      - name: idContext
        in: query
        required: false
        description: Used to identify the source of the identifier (e.g., IATA, ABTA).
        schema:
          type: string
      - name: type
        in: query
        required: false
        description: A reference to the type of object defined by the UniqueID element.
        schema:
          type: string
      - name: guaranteeCode
        in: query
        required: false
        description: The guarantee code to retrieve authorization rules for.
        schema:
          type: string
      - name: rateCode
        in: query
        required: false
        description: The rate code to retrieve authorization rules for.
        schema:
          type: string
      - name: roomType
        in: query
        required: false
        description: The room type to retrieve authorization rules for.
        schema:
          type: string
      - name: sourceCode
        in: query
        required: false
        description: The source code to retrieve authorization rules for.
        schema:
          type: string
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: The result element containing the authorization rule matching the requested criteria.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/authorizationRule'
        '204':
          description: AuthorizationRule not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - CreditCard
  /cardReaderDelimiters:
    get:
      summary: Operation to fetch CardReaderDelimiters.
      description: ' <p><strong>OperationId:</strong>getCardReaderDelimiters</p>'
      operationId: getCardReaderDelimiters
      parameters:
      - name: deviceID
        in: query
        x-example: '120'
        required: false
        schema:
          type: integer
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: Response for reading the configured device delimiters.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/cardReaderDelimiters'
        '204':
          description: CardReaderDelimiters not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - CreditCard
  /creditCardInfo:
    get:
      summary: Operation to fetch CreditCardInfo.
      description: Use this API to return the token inclusive cardType and expirationDate for the credit card used in a specific reservation. Oracle does not provide any credit card numbers. Include the hotelId and the cardId in the parameters. The cardId can be returned with the getReservation operation. <p><strong>OperationId:</strong>getCreditCardInfo</p>
      operationId: getCreditCardInfo
      parameters:
      - name: hotelId
        in: query
        required: true
        description: Used for codes in the OPERA Code tables. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X.
        schema:
          type: string
      - name: reservationId
        in: query
        required: false
        description: A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.
        schema:
          type: string
      - name: idExtension
        in: query
        required: false
        description: Additional identifying value assigned by the creating system.
        schema:
          type: integer
      - name: idContext
        in: query
        required: false
        description: Used to identify the source of the identifier (e.g., IATA, ABTA).
        schema:
          type: string
      - name: type
        in: query
        required: false
        description: A reference to the type of object defined by the UniqueID element.
        schema:
          type: string
      - name: cardId
        in: query
        required: false
        description: A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.
        schema:
          type: string
      - name: cardIdExtension
        in: query
        required: false
        description: Additional identifying value assigned by the creating system.
        schema:
          type: integer
      - name: cardIdContext
        in: query
        required: false
        description: Used to identify the source of the identifier (e.g., IATA, ABTA).
        schema:
          type: string
      - name: cardIdType
        in: query
        required: false
        description: A reference to the type of object defined by the UniqueID element.
        schema:
          type: string
      - name: accessTransactionType
        in: query
        required: false
        description: Currently supported transaction type categories used for credit card authorization.
        schema:
          type: string
          enum:
          - Additional
          - ArPayment
          - Batch
          - BatchDeposit
          - BatchDepositRefund
          - Billing
          - CheckIn
          - CheckInManualAuth
          - Deposit
          - EndOfDay
          - EndOfDayDeposit
          - Manual
          - Other
          - PasserBy
          - PostIt
          - PreCheckIn
          - Refund
          - Scheduled
          uniqueItems: true
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: Respose for the fetch credit card information.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/creditCardInfo'
        '204':
          description: CreditCardInfo not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - CreditCard
  /creditCardTypes/validate:
    get:
      summary: Operation to validate CreditCardType.
      description: ' <p><strong>OperationId:</strong>validateCreditCardType</p>'
      operationId: validateCreditCardType
      parameters:
      - name: reservationID
        in: query
        required: false
        description: A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.
        schema:
          type: string
      - name: reservationIDIdExtension
        in: query
        required: false
        description: Additional identifying value assigned by the creating system.
        schema:
          type: integer
      - name: reservationIDIdContext
        in: query
        required: false
        description: Used to identify the source of the identifier (e.g., IATA, ABTA).
        schema:
          type: string
      - name: reservationIDType
        in: query
        required: false
        description: A reference to the type of object defined by the UniqueID element.
        schema:
          type: string
      - name: paymentMethodDescription
        in: query
        required: false
        schema:
          type: string
      - name: paymentMethodFolioView
        in: query
        required: false
        schema:
          type: integer
      - name: paymentMethod
        in: query
        required: false
        schema:
          type: string
      - name: attachCreditCardToProfile
        in: query
        required: false
        description: Attach the credit card to profile.
        schema:
          type: boolean
      - name: cardHolderName
        in: query
        required: false
        schema:
          type: string
      - name: cardNumber
        in: query
        required: false
        schema:
          type: string
      - name: cardNumberLast4Digits
        in: query
        required: false
        schema:
          type: string
      - name: cardNumberMasked
        in: query
        required: false
        schema:
          type: string
      - name: cardNumberType
        in: query
        required: false
        description: Simple type for indicating if credit card number is tokenized.
        schema:
          type: string
          enum:
          - CardNumber
          - Token
          uniqueItems: true
      - name: cardType
        in: query
        required: false
        description: This is required for Credit Card Payment Methods. This indicates the type of Credit Card associated with this payment method.
        schema:
          type: string
          enum:
          - Ab
          - Am
          - Ax
          - Cb
          - Dc
          - Ds
          - Dt
          - Ec
          - Er
          - Jc
          - Jl
          - Mc
          - Nb
          - So
          - St
          - Sw
          - Va
          - Xy
          - Zz
          - Cp
          - Cu
          uniqueItems: true
      - name: expirationDate
        in: query
        required: false
        description: Expiration date of the credit card
        schema:
          type: string
          format: date
      - name: expirationDateExpired
        in: query
        required: false
        schema:
          type: boolean
      - name: expirationDateMasked
        in: query
        required: false
        description: Masked Expiration date of the credit card
        schema:
          type: string
      - name: processing
        in: query
        required: false
        schema:
          type: string
          enum:
          - Eft
          - Manual
          uniqueItems: true
      - name: swiped
        in: query
        required: false
        schema:
          type: boolean
      - name: userDefinedCardType
        in: query
        required: false
        description: Indicates the user defined credit card type if credit card type from a defined list is not provided
        schema:
          type: string
      - name: cardId
        in: query
        required: false
        description: A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.
        schema:
          type: string
      - name: cardIdExtension
        in: query
        required: false
        description: Additional identifying value assigned by the creating system.
        schema:
          type: integer
      - name: cardIdContext
        in: query
        required: false
        description: Used to identify the source of the identifier (e.g., IATA, ABTA).
        schema:
          type: string
      - name: cardIdType
        in: query
        required: false
        description: A reference to the type of object defined by the UniqueID element.
        schema:
          type: string
      - name: currentAuthorizedAmount
        in: query
        required: false
        description: A monetary amount.
        schema:
          type: number
      - name: currentAuthorizedAmountCurrencyCode
        in: query
        required: false
        description: Provides a currency code to reflect the currency in which an amount may be expressed.
        schema:
          type: string
      - name: approvalAmountNeeded
        in: query
        required: false
        description: A monetary amount.
        schema:
          type: number
      - name: approvalAmountNeededCurrencyCode
        in: query
        required: false
        description: Provides a currency code to reflect the currency in which an amount may be expressed.
        schema:
          type: string
      - name: balanceAmount
        in: query
        required: false
        description: A monetary amount.
        schema:
          type: number
      - name: balanceCurrencyCode
        in: query
        required: false
        description: Provides a currency code to reflect the currency in which an amount may be expressed.
        schema:
          type: string
      - name: authorizationRuleCode
        in: query
        required: false
        description: The authorization rule code.
        schema:
          type: integer
      - name: authorizationRuleAmount
        in: query
        required: false
        description: A monetary amount.
        schema:
          type: number
      - name: authorizationRuleCurrencyCode
        in: query
        required: false
        description: Provides a currency code to reflect the currency in which an amount may be expressed.
        schema:
          type: string
      - name: authorizationRulePercent
        in: query
        required: false
        description: A percentage value if the authorization rule is percentage based.
        schema:
          type: number
      - name: emailFolio
        in: query
        required: false
        schema:
          type: boolean
      - name: emailFolioInfoId
        in: query
        required: false
        description: A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation.
        schema:
          type: string
      - name: emailFolioInfoIDExtension
        in: query
        required: false
        description: Additional identifying value assigned by the creating system.
        schema:
          type: integer
      - name: emailFolioInfoIDContext
        in: query
        required: false
        description: Used to identify the source of the identifier (e.g., IATA, ABTA).
        schema:
          type: string
      - name: emailFolioInfoType
        in: query
        required: false
        description: A reference to the type of object defined by the UniqueID element.
        schema:
          type: string
      - name: emailFolioInfoCreateDateTime
        in: query
        required: false
        description: Time stamp of the creation.
        schema:
          type: string
          format: date-time
      - name: emailFolioInfoCreatorID
        in: query
        required: false
        description: ID of creator. The creator could be a software system identifier or an identifier of an employee responsible for the creation.
        schema:
          type: string
      - name: emailFolioInfoEmailAddress
        in: query
        required: false
        description: Defines the e-mail address.
        schema:
          type: string
      - name: emailFolioInfoEmailFormat
        in: query
        required: false
        description: Supported Email format.
        schema:
          type: string
          enum:
          - Html
          - Text
          uniqueItems: true
      - name: emailFolioInfoLastModifierID
        in: query
        required: false
        description: Identifies the last software system or person to modify a record.
        schema:
          type: string
      - name: emailFolioInfoLastModifyDateTime
        in: query
        required: false
        description: Time stamp of last modification.
        schema:
          type: string
          format: date-time
      - name: emailFolioInfoOrderSequence
        in: query
        required: false
        description: Display Order sequence.
        schema:
          type: number
      - name: emailFolioInfoPrimaryInd
        in: query
        required: false
        description: When true, indicates a primary information.
        schema:
          type: boolean
      - name: emailFolioInfoPurgeDate
        in: query
        required: false
        description: Date an item will be purged from a database (e.g., from a live database to an archive).
        schema:
          type: string
          format: date
      - name: emailEmailFolioInfoType
        in: query
        required: false
        description: Defines the purpose of the e-mail address (e.g. personal, business, listserve).
        schema:
          type: string
      - name: emailFolioInfoTypeDescription
        in: query
        required: false
        description: Describes the Type code
        schema:
          type: string
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: The result element from validating a credit card number against its vendor's format requirements.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/creditCardTypeValidationStatus'
        '204':
          description: validateCreditCardType not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - CreditCard
  /creditCards/decode:
    get:
      summary: Operation to Decode Card.
      description: ' <p><strong>OperationId:</strong>decodeCard</p>'
      operationId: decodeCard
      parameters:
      - name: hotelId
        in: query
        required: true
        description: Used for codes in the OPERA Code tables. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X.
        schema:
          type: string
      - name: trackData
        in: query
        required: false
        description: Used for Character Strings, length 0 to 200.
        schema:
          type: string
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: Respose for the decoded card information.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/decodedCard'
        '204':
          description: decodeCard not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - CreditCard
  /creditCards/readerDevices:
    get:
      summary: Operation to fetch CreditCardReaderDevices.
      description: ' <p><strong>OperationId:</strong>getCreditCardReaderDevices</p>'
      operationId: getCreditCardReaderDevices
      parameters:
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
          description: Response for fetching list of supported credit card reader devices.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/creditCardReaderDevices'
        '204':
          description: CreditCardReaderDevices not found.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - CreditCard
  /creditCards/vaultedId:
    post:
      summary: Operation to fetch CreditCardUniqueId.
      description: ' <p><strong>OperationId:</strong>getCreditCardUniqueId</p>'
      operationId: getCreditCardUniqueId
      parameters:
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '201':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
            Location:
              description: Location of newly created resource
              schema:
                type: string
          description: Response for fetching credit card unique id.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/creditCardUniqueId'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/components/responses/413'
        '414':
          $ref: '#/components/responses/414'
        '415':
          $ref: '#/components/responses/415'
        '500':
          $ref: '#/components/responses/500'
        '502':
          $ref: '#/components/responses/502'
        '503':
          $ref: '#/components/responses/503'
      tags:
      - CreditCard
      requestBody:
        content:
          application/json;charset=UTF-8:
            schema:
              allOf:
              - $ref: '#/components/schemas/creditCardUniqueIdRQ'
        description: Request for fetching credit card unique id.
        required: true
  /hotels/{hotelId}/interfaces/{interfaceLogoId}/customData:
    put:
      summary: Operation to update hotel interface custom data.
      description: Operation to update hotel interface custom data. <p><strong>OperationId:</strong>updateInterfaceCustomData</p>
      operationId: updateInterfaceCustomData
      parameters:
      - name: interfaceLogoId
        in: path
        required: true
        description: Unique ID of the hotel interface logo
        schema:
          type: string
          maxLength: 2000
          minLength: 1
      - name: hotelId
        in: path
        required: true
        description: Unique ID of the hotel in OPERA
        schema:
          type: string
          maxLength: 2000
          minLength: 1
      - $ref: '#/components/parameters/authKey'
      - $ref: '#/components/parameters/externalData'
      - $ref: '#/components/parameters/x-app-key'
      - $ref: '#/components/parameters/x-request-id'
      - $ref: '#/components/parameters/x-originating-application'
      - $ref: '#/components/parameters/x-hotelid'
      - $ref: '#/components/parameters/x-externalsystem'
      - $ref: '#/components/parameters/Accept-Language'
      responses:
        '200':
          headers:
            Content-Language:
              description: Audience language
              x-example: en-GB
              schema:
                type: string
                pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*'
            Location:
              description: Location of newly created resource
              schema:
                type: string
          description: Response Body.
          content:
            application/json;charset=UTF-8:
              schema:
                $ref: '#/components/schemas/status'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '405':
          $ref: '#/components/responses/405'
        '406':
          $ref: '#/components/responses/406'
        '413':
          $ref: '#/component

# --- truncated at 32 KB (137 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-creditcard-api-openapi.yml