Amadeus · Schema

PaymentInput

Model with the hotel payment information

TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Properties

Name	Type	Description
iataTravelAgency	object	Agency IATA/ARC Number used to Guarantee the booking. If not provided it is taken form the Amadeus Office profile.
method	string	Indicates the method of payment. - CREDIT_CARD : It allows payment through a credit card. It is expected to provide the credit card information in the paymentCard section.
paymentCard	object	Credit card information. The full details of a credit card are expected : . credit card holder name (mandatory, maximum 64 chars) . credit card vendor code (mandatory) . credit card number (mandatory)

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/hotel-booking-payment-input-schema.json",
  "title": "PaymentInput",
  "description": "Model with the hotel payment information",
  "type": "object",
  "properties": {
    "iataTravelAgency": {
      "type": "object",
      "description": "Agency IATA/ARC Number used to Guarantee the booking.\nIf not provided it is taken form the Amadeus Office profile.",
      "properties": {
        "iataNumber": {
          "type": "string",
          "example": "CDG"
        }
      }
    },
    "method": {
      "type": "string",
      "description": "Indicates the method of payment. \n- CREDIT_CARD : It allows payment through a credit card. It is expected to provide the credit card information in the paymentCard section.",
      "enum": [
        "CREDIT_CARD"
      ],
      "example": "CREDIT_CARD"
    },
    "paymentCard": {
      "type": "object",
      "description": "Credit card information.\nThe full details of a credit card are expected :\n  . credit card holder name (mandatory, maximum 64 chars) \n  . credit card vendor code (mandatory)\n  . credit card number (mandatory)\n  . credit card expiry date (mandatory)\n  . credit card security code (optional, it is anyway strongly recommended to always provide it for Aggregators)",
      "properties": {
        "paymentCardInfo": {
          "type": "object",
          "description": "Credit or Debits cards.",
          "title": "PaymentCard",
          "properties": {
            "vendorCode": {
              "type": "string",
              "example": "VI",
              "description": "Two-letter code card type or vendor code. E.g. VI for VISA, MA for MasterCard.",
              "maxLength": 30,
              "minLength": 0
            },
            "holderName": {
              "type": "string",
              "description": "Name of credit card holder.",
              "maxLength": 99,
              "minLength": 1,
              "example": "Sample Name"
            },
            "cardNumber": {
              "type": "string",
              "description": "Card number",
              "example": 1
            },
            "securityCode": {
              "type": "string",
              "description": "Card security code",
              "example": "193",
              "minLength": 3,
              "maxLength": 4
            },
            "expiryDate": {
              "type": "string",
              "description": "Date of the expiration of the card in the format MMYY",
              "example": "2026-08-15"
            }
          },
          "required": [
            "vendorCode",
            "holderName",
            "cardNumber",
            "expiryDate"
          ]
        },
        "address": {
          "type": "object",
          "description": "Address information",
          "title": "Address",
          "properties": {
            "lines": {
              "type": "array",
              "description": "Line 1 = Street address, Line 2 = Apartment, suite, unit, building, floor, etc",
              "items": {
                "type": "string"
              }
            },
            "postalCode": {
              "type": "string",
              "description": "Example: 74130",
              "example": "string-value"
            },
            "countryCode": {
              "type": "string",
              "description": "ISO 3166-1 country code",
              "pattern": "[a-zA-Z]{2}",
              "example": "FR"
            },
            "cityName": {
              "type": "string",
              "description": "Full city name. Example: Dublin",
              "pattern": "[a-zA-Z -]{1,35}",
              "example": "Paris"
            },
            "stateCode": {
              "type": "string",
              "description": "State code (two character standard IATA state code)",
              "pattern": "[a-zA-Z0-9]{1,2}",
              "example": "string-value"
            }
          },
          "required": [
            "postalCode",
            "countryCode",
            "cityName"
          ]
        }
      },
      "required": [
        "paymentCardInfo"
      ]
    }
  },
  "required": [
    "method"
  ]
}