Tariff

A rate contains application rules, the cost of a one-day stay, and refund conditions. The rules set the conditions for search criteria: the date range and guests.

Example:

{
    "id": "basic_tariff",
    "conditions": {
        "dates": [
            {
                "min": "2022-05-01",
                "max": "2022-05-03"
            }
        ],
        "occupancy": {
            "adults": {
                "min": 2,
                "max": 2
            },
            "childrenAges": [
                {"max": 3},
                {"max": 7}
            ]
        }
    },
    "rate": {
        "amount": "5000",
        "currency": "RUB"
    },
    "refundRules": [
        {
            "type": "fullyRefundable",
            "endsAt": "P3D"
        },
        {
            "type": "refundableWithPenalty",
            "startsAt": "P3D",
            "endsAt": "P1D",
            "penalty": {
                "amount": "500",
                "currency": "RUB"
            }
        },
        {
            "type": "nonRefundable",
            "startsAt": "P1D"
        }
    ],
    "expiredDate": "2022-05-02T12:00:00Z"
}

Field

Required

Type

Restrictions

Description

id

Yes

String

[a-zA-Z0-9-_]{1,255}

The rate ID. Passed in the landing page click parameters.

conditions

Yes

Object

The rate application rules. The Conditions model.

rate

Yes

Object

The cost of a one-day stay according to this rate. The Money model.

refundRules

No

Object[]

Conditions for a refund. If there is no value, the rate is considered non-refundable. The RefundRule model.

expiredDate

No

Date

The date after which the rate will be deleted without the partner's request. Set in ISO 8601 format. If no value is provided, it defaults to the date that is one day later than the latest available date in the conditions.dates field of the rate.

Previous