Указание типов платежей,Определение типов платежей

Предварительные условия

Чтобы выполнить это руководство, вам необходимо выполнить следующее:

  1. Понимание нашей платежной политики.
  2. Завершена часть вашей интеграции E2E с экспортными фидами .

Для этого дополнения поддерживаются следующие типы платежей:

  1. Предварительная оплата
  2. Плата за отсутствие явки/Плата за отмену бронирования
  3. Депозит
  4. Требуется кредитная карта

Все варианты использования платежей являются расширениями варианта использования без платежей/оплаты по прибытии (который не требует настройки платежей), поэтому это руководство начнется с описания этой конфигурации и рассмотрения других конфигураций как расширений.

Предварительная оплата

Эта конфигурация используется для указания того, что сумма за услугу должна быть оплачена полностью во время бронирования. Предоплата указывается на уровне доступности через поле payment в фиде Avaibility .

{
  "availability": [{
    "merchant_id": "dining-A",
    "service_id": "reservation",
    "start_sec": 1535853600,
    "duration_sec": 2700,
    "spots_total": 2,
    "spots_open": 2,
    "resources": {
    "room_id": "A-dining-room",
    "room_name": "Wine Tasting Room",
    "party_size": 2,
    "prepayment": {
      "price_info": {
        "price": {
          "price_micros": 200000000,
          "currency_code": "USD",
          },
        "price_type": "PER_PERSON"
        }
      }
    }
  }]
}

Плата за незаезд

Плата за незаезд может быть взимана с пользователя, если он не явится при бронировании или откажется от бронирования после периода отмены . Если окно отмены не указано, по умолчанию будет установлено время начала слота.

Чтобы указать плату за неявку, в фиде услуги необходимо включить поле no_show_fee , как показано в следующем примере:

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    },
    "scheduling_rules": {
        "min_advance_online_canceling": 14400,
    },
    "no_show_fee": {
        "fee": {
            "price_micros": 25000000,
            "currency_code": "USD"
        },
        "fee_type": "FIXED_RATE_DEFAULT"
    }
}

В этом примере партнер или продавец имеет право взимать фиксированную плату в размере 25 долларов США, как указано в поле no_show_fee.fee.price_micros , если владелец встречи не присутствует на встрече. Эта плата также может взиматься, если пользователь отменяет встречу в течение 4 часов (14 400 секунд) до встречи, как указано в поле scheduling_rules.min_advance_online_canceling .

Чтобы узнать, как определить плату за показ в фиде доступности, см. раздел «Переопределение цен на уровне доступности» .

Плату за незаезд можно дополнительно настроить так, чтобы она взималась с человека за бронирование. В этом случае для no_show_fee.fee.fee_type можно установить значение PER_PERSON .

Депозит

Депозиты используются для получения первоначального взноса, необходимого для бронирования. Залог может взиматься во время бронирования или позднее. Возможно, вам потребуется определить, на каких условиях подлежит возврату депозит, а также когда бронирование можно отменить онлайн .

Чтобы указать депозит, в фиде сервиса необходимо включить поле deposit , как показано в следующем примере:

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    },
    "scheduling_rules": {
        "min_advance_online_canceling": 86400,
    },
    "deposit": {
        "deposit": {
            "price_micros": 25000000,
            "currency_code": "USD",
            "min_advance_cancellation_sec": 14400,
        },
        "deposit_type": "FIXED_RATE_DEFAULT"
    }
}

В этом примере min_advance_online_canceling определяет окно отмены, а deposit.min_advance_cancellation_sec определяет, когда депозит подлежит возврату. Обратите внимание, что в примере депозита можно указать время отмены отдельно от условий возврата. В этом случае пользователь сможет отменить услугу онлайн не позднее, чем за 24 часа (86400 секунд). Это гарантирует, что продавец будет напрямую проинформирован о любых поздних аннулированиях. Тем не менее, пользователь по-прежнему может иметь право на возврат своего депозита не позднее, чем за 4 часа (14 400 секунд) до бронирования (путем обращения к вам или продавцу по поводу отмены), что будет указано в условиях при оформлении заказа и в электронное письмо с подтверждением.

Чтобы узнать, как можно определить депозиты на уровне доступности, см. Переопределение цен на уровне доступности .

Также обратите внимание, что, как и в случае с комиссией за неявку, депозит может взиматься либо по фиксированной ставке, либо по ставке за человека. В этом случае депозит представляет собой фиксированную ставку в размере 25 долларов США, как указано в "deposit_type": "FIXED_RATE_DEFAULT" . Если бронирование включает в себя размер группы, депозит можно указать как депозит на человека, установив "deposit_type": "PER_PERSON" .

Требовать кредитную карту

Служба может потребовать кредитную карту в качестве дополнительного способа подтверждения личности. Однако его не следует использовать для предоплаты, депозитов или сборов за неявку . Если эти варианты использования необходимы, их следует настроить явно. Требование кредитной карты часто приводит к значительному снижению количества заказов на эту услугу.

Чтобы потребовать предоставления кредитной карты при оформлении заказа, вы должны установить в поле require_credit_card значение REQUIRE_CREDIT_CARD_ALWAYS .

{
    "merchant_id": "merchant-1",
    "service_id": "reservation",
    "name": "reservation",
    "description": "Food reservation",
    "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}

Переопределить цену на уровне доступности

Структура цен и комиссий определяется на уровне Сервиса. В большинстве случаев следует использовать цены на уровне обслуживания. Однако имеет смысл изменить структуру платежей для определенных слотов доступности. Например, следующие ситуации можно решить путем переопределения цен или сборов на уровне доступности:

  • Цены снижаются по вторникам и повышаются по субботам.
  • Плата за показ не взимается при наличии мест с 17:00 до 19:00.
  • Требуйте залога для партий, превышающих 6 человек.
  • Для бронирования определенного номера требуется кредитная карта.

В таблице типов платежей для каждого метода оплаты/комиссии указано, какое поле следует использовать в канале доступности, чтобы переопределить определение уровня обслуживания.

Способ оплаты Определение фида Переопределяемый?
Предварительная оплата Наличие.предоплата Не переоценивается
Нет платы за показ Service.no_show_fee Доступность.no_show_fee
Депозит Сервис.депозит Наличие.депозит
,

Предварительные условия

Чтобы выполнить это руководство, вам необходимо выполнить следующее:

  1. Понимание нашей платежной политики.
  2. Завершена часть вашей интеграции E2E с экспортными фидами .

Для этого дополнения поддерживаются следующие типы платежей:

  1. Предварительная оплата
  2. Плата за отсутствие явки/Плата за отмену бронирования
  3. Депозит
  4. Требуется кредитная карта

Все варианты использования платежей являются расширениями варианта использования без платежей/оплаты по прибытии (который не требует настройки платежей), поэтому это руководство начнется с описания этой конфигурации и рассмотрения других конфигураций как расширений.

Предварительная оплата

Эта конфигурация используется для указания того, что сумма за услугу должна быть оплачена полностью во время бронирования. Предоплата указывается на уровне доступности через поле payment в фиде Avaibility .

{
  "availability": [{
    "merchant_id": "dining-A",
    "service_id": "reservation",
    "start_sec": 1535853600,
    "duration_sec": 2700,
    "spots_total": 2,
    "spots_open": 2,
    "resources": {
    "room_id": "A-dining-room",
    "room_name": "Wine Tasting Room",
    "party_size": 2,
    "prepayment": {
      "price_info": {
        "price": {
          "price_micros": 200000000,
          "currency_code": "USD",
          },
        "price_type": "PER_PERSON"
        }
      }
    }
  }]
}

Плата за незаезд

Плата за незаезд может быть взимана с пользователя, если он не явится при бронировании или откажется от бронирования после периода отмены . Если окно отмены не указано, по умолчанию будет установлено время начала слота.

Чтобы указать плату за неявку, в фиде услуги необходимо включить поле no_show_fee , как показано в следующем примере:

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    },
    "scheduling_rules": {
        "min_advance_online_canceling": 14400,
    },
    "no_show_fee": {
        "fee": {
            "price_micros": 25000000,
            "currency_code": "USD"
        },
        "fee_type": "FIXED_RATE_DEFAULT"
    }
}

В этом примере партнер или продавец имеет право взимать фиксированную плату в размере 25 долларов США, как указано в поле no_show_fee.fee.price_micros , если владелец встречи не присутствует на встрече. Эта плата также может взиматься, если пользователь отменяет встречу в течение 4 часов (14 400 секунд) до встречи, как указано в поле scheduling_rules.min_advance_online_canceling .

Чтобы узнать, как определить плату за показ в фиде доступности, см. раздел «Переопределение цен на уровне доступности» .

Плату за незаезд можно дополнительно настроить так, чтобы она взималась с человека за бронирование. В этом случае для no_show_fee.fee.fee_type можно установить значение PER_PERSON .

Депозит

Депозиты используются для получения первоначального взноса, необходимого для бронирования. Залог может взиматься во время бронирования или позднее. Возможно, вам потребуется определить, на каких условиях подлежит возврату депозит, а также когда бронирование можно отменить онлайн .

Чтобы указать депозит, в фиде сервиса необходимо включить поле deposit , как показано в следующем примере:

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Reservation",
    "description": "A dining reservation",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    },
    "scheduling_rules": {
        "min_advance_online_canceling": 86400,
    },
    "deposit": {
        "deposit": {
            "price_micros": 25000000,
            "currency_code": "USD",
            "min_advance_cancellation_sec": 14400,
        },
        "deposit_type": "FIXED_RATE_DEFAULT"
    }
}

В этом примере min_advance_online_canceling определяет окно отмены, а deposit.min_advance_cancellation_sec определяет, когда депозит подлежит возврату. Обратите внимание, что в примере депозита можно указать время отмены отдельно от условий возврата. В этом случае пользователь сможет отменить услугу онлайн не позднее, чем за 24 часа (86400 секунд). Это гарантирует, что продавец будет напрямую проинформирован о любых поздних аннулированиях. Тем не менее, пользователь по-прежнему может иметь право на возврат своего депозита не позднее чем за 4 часа (14 400 секунд) до бронирования (путем обращения к вам или продавцу по поводу отмены), что будет указано в условиях при оформлении заказа и в электронное письмо с подтверждением.

Чтобы узнать, как можно определить депозиты на уровне доступности, см. Переопределение цен на уровне доступности .

Также обратите внимание, что, как и в случае с комиссией за неявку, депозит может взиматься либо по фиксированной ставке, либо по ставке за человека. В этом случае депозит представляет собой фиксированную ставку в размере 25 долларов США, как указано в "deposit_type": "FIXED_RATE_DEFAULT" . Если бронирование включает в себя размер группы, депозит можно указать как депозит на человека, установив "deposit_type": "PER_PERSON" .

Требовать кредитную карту

Службе может потребоваться кредитная карта в качестве дополнительного способа подтверждения личности. Однако его не следует использовать для предоплаты, депозитов или сборов за неявку . Если эти варианты использования необходимы, их следует настроить явно. Требование кредитной карты часто приводит к значительному снижению количества заказов на эту услугу.

Чтобы потребовать предоставления кредитной карты при оформлении заказа, вы должны установить в поле require_credit_card значение REQUIRE_CREDIT_CARD_ALWAYS .

{
    "merchant_id": "merchant-1",
    "service_id": "reservation",
    "name": "reservation",
    "description": "Food reservation",
    "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}

Переопределить цену на уровне доступности

Структура цен и комиссий определяется на уровне Сервиса. В большинстве случаев следует использовать цены на уровне обслуживания. Однако имеет смысл изменить структуру платежей для определенных слотов доступности. Например, следующие ситуации можно решить путем переопределения цен или сборов на уровне доступности:

  • Цены снижаются по вторникам и повышаются по субботам.
  • Плата за показ не взимается при наличии мест с 17:00 до 19:00.
  • Требуйте залога для партий, превышающих 6 человек.
  • Для бронирования определенного номера требуется кредитная карта.

В таблице типов платежей для каждого метода оплаты/комиссии указано, какое поле следует использовать в канале доступности, чтобы переопределить определение уровня обслуживания.

Способ оплаты Определение фида Переопределяемый?
Предварительная оплата Наличие.предоплата Не переоценивается
Нет платы за показ Service.no_show_fee Доступность.no_show_fee
Депозит Сервис.депозит Наличие.депозит