Amadeus · Schema

HotelProduct_DepositPolicy

the deposit/prepay policy information applicable to the offer. It includes accepted payments, deadline and the amount due

TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Properties

Name Type Description
amount string Deposit-Prepay amount
deadline string The date and time of the deadline in ISO 8601[https://www.w3.org/TR/NOTE-datetime]. Example: 2010-08-14T13:00:00 Please note that this value is expressed in the hotels local time zone
description object Specific type to convey a list of string for specific information type ( via qualifier) in specific character set, or language
acceptedPayments object Accepted Payment Methods and Card Types. Several Payment Methods and Card Types may be available.
View JSON Schema on GitHub

JSON Schema

hotel-booking-hotel-product-deposit-policy-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/hotel-booking-hotel-product-deposit-policy-schema.json",
  "title": "HotelProduct_DepositPolicy",
  "description": "the deposit/prepay policy information applicable to the offer. It includes accepted payments, deadline and the amount due",
  "type": "object",
  "properties": {
    "amount": {
      "type": "string",
      "description": "Deposit-Prepay amount",
      "pattern": "^\\\\d+(\\\\.\\\\d+)?$",
      "example": "199.50"
    },
    "deadline": {
      "type": "string",
      "format": "date-time",
      "description": "The date and time of the deadline in ISO 8601[https://www.w3.org/TR/NOTE-datetime]. \n Example: 2010-08-14T13:00:00\n Please note that this value is expressed in the hotels local time zone\n",
      "example": "2026-08-15T10:30:00Z"
    },
    "description": {
      "type": "object",
      "description": "Specific type to convey a list of string for specific information type ( via qualifier) in specific character set, or language",
      "title": "QualifiedFreeText",
      "properties": {
        "text": {
          "type": "string",
          "description": "Free Text",
          "example": "Do you need and example ?"
        },
        "lang": {
          "type": "string",
          "description": "see RFC 5646",
          "example": "fr-FR"
        }
      }
    },
    "acceptedPayments": {
      "title": "HotelProduct_PaymentPolicy",
      "type": "object",
      "description": "Accepted Payment Methods and Card Types. Several Payment Methods and Card Types may be available.",
      "properties": {
        "creditCards": {
          "type": "array",
          "description": "Accepted Payment Card Types for the `method` CREDIT_CARD",
          "items": {
            "type": "string",
            "pattern": "^[A-Z]{2}$",
            "minLength": 2,
            "maxLength": 2,
            "example": "VI",
            "description": "card type (CA, VI, AX, DC...)\nExamples:\n  * CA - Mastercard (warning: use it instead of MC/IK/EC/MD/XS)\n  * VI - VISA\n  * AX - AMERICAN EXPRESS\n  * DC - Diners Club\n  * DS - DISCOVER\n  * JC - JCB\n  * TP - UATP / AirPlus\n  * UP - UnionPay  \n"
          },
          "example": [
            "CA",
            "VI",
            "AX"
          ]
        },
        "methods": {
          "type": "array",
          "description": "Accepted Payment Methods",
          "items": {
            "type": "string",
            "example": "CREDIT_CARD",
            "enum": [
              "CREDIT_CARD",
              "CREDIT_CARD_AGENCY",
              "CREDIT_CARD_TRAVELER",
              "VCC_BILLBACK",
              "VCC_B2B_WALLET",
              "TRAVEL_AGENT_ID",
              "AGENCY_ACCOUNT",
              "CORPORATE_ID",
              "CHECK",
              "ADVANCE_DEPOSIT",
              "COMPANY_ADDRESS",
              "HOTEL_GUEST_ID",
              "MISC_CHARGE_ORDER",
              "DEFERED_PAYMENT",
              "TRAVEL_AGENT_IMMEDIATE"
            ],
            "description": "The Payment Methods :\n * CREDIT_CARD (CC) - Payment Cards in `creditCards` are accepted\n * CREDIT_CARD_AGENCY (CA) - Payment Cards in `creditCards` are accepted\n * CREDIT_CARD_TRAVELER (CC) - Payment Cards in `creditCards` are accepted\n * AGENCY_ACCOUNT - Agency Account (Credit Line) is accepted. Agency is Charged at CheckOut\n * TRAVEL_AGENT_ID - Agency IATA/ARC Number is accepted to Guarantee the booking\n * CORPORATE_ID (COR-ID) - Corporate Account is accepted to Guarantee the booking\n * HOTEL_GUEST_ID - Hotel Chain Rewards Card Number is accepted to Guarantee the booking\n * CHECK - Checks are accepted\n * MISC_CHARGE_ORDER - Miscellaneous Charge Order is accepted\n * ADVANCE_DEPOSIT - Cash is accepted for Deposit/PrePay\n * COMPANY_ADDRESS - Company Billing Address is accepted to Guarantee the booking"
          }
        }
      }
    }
  }
}