Шаблоны URL для перенаправления платежей

После бронирования свободного времени по определенной цене пользователь будет перенаправлен на вашу страницу бронирования по URL-адресу, указанному вами. Ниже описаны следующие шаги:

  1. Определите свой шаблон URL.
  2. Установите свой шаблон URL-адреса в своих лентах.
  3. Включить возможность отсоединения для каждого доступного временного интервала.
  4. Проверьте поля в Центре действий.

1. Определение шаблона URL-адреса.

Шаблон URI соответствует спецификации RFC6570 Level 2 Uri Template Рабочей группы по проектированию интернета (IETF), более подробная информация доступна на сайте datatracker.ietf.org . URL-адрес задается вами с помощью параметров, которые динамически заполняются информацией, относящейся к данному резервированию. В следующей таблице приведены обязательные и необязательные параметры, доступные для вашего шаблона URI.

`https://reservation-provider.com/examplerestaurant/book?date={availability_slot_start_seconds}&num_guests={resources_party_size}`

Доступные значения для шаблона URL

Параметры шаблона Обязательный / Необязательный Кормить Поле Пример значения
availability_slot_start_seconds Необходимый доступность старт_сек 4152695841
resources_party_size Необходимый доступность.ресурсы размер_партии 2
доступность_места_доступность_тег Необязательный доступность доступность_тег res-123
availability_slot_duration_seconds Необязательный доступность длительность_сек 3600

2. Установите свой шаблон URI в ленте.

В следующем разделе предполагается, что у вас уже есть работающая сквозная интеграция с существующим сервисным каналом . Определенный вами URL-адрес будет установлен в сервисном канале; ниже приведено определение этого поля.

message Service {
  // ..
  UriTemplate uri_template = 38;
}

Определение шаблона URI 

// A template specifying how Google should generate URLs to external site.
message UriTemplate {
  // The uri template must follow the RFC6570, see
  // https://datatracker.ietf.org/doc/html/rfc6570.
  // Supports Level 2 templates.
  // These parameters will be resolved to their values specified in their
  // respective entities.
  //
  // Available parameters for Dining Reservation Linkout:
  // 1) (required) {availability_slot_start_seconds} :: populated from start_sec
  //   field in availability feed
  // 2) (required) {resources_party_size} :: populated from party_size field in
  //   availability feed
  // 3) (optional) {availability_slot_duration_seconds} :: populated from
  //   duration_sec field in availability feed
  // 4) (optional) {availability_slot_availability_tag} :: populated from
  //   availability_tag field in availability feed
  //
  // Example usage:
  // http://example.com/book/restaurant?start={availability_slot_start_seconds}
  // &num_guests={resources_party_size}
  // * start_sec = 123456
  // * party_size = 2
  // https://example.com/book/restaurant?start=123456&num_guests=2
  string uri_template = 1;
}

Определение образца услуги 

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 1,
    "nonce": "12484913",
    "generation_timestamp": 1530432018
  },
  "service": [
    {
      "merchant_id": "dining-A",
      "service_id": "reservation",
      "uri_template": {
        "uri_template": "https://reservation-provider.com/examplerestaurant/book?date={availability_slot_start_seconds}&num_guests={resources_party_size}"
      },
      "localized_service_name": {
        "value": "Reservation",
        "localized_value": [
          {
            "locale": "en",
            "value": "Reservation"
          }
        ]
      }
    }
  ]
}

В следующем разделе предполагается, что у вас уже есть работающая сквозная интеграция с существующим каналом доступности . После того, как вы установите шаблон URL-адреса в своем канале услуг, вам потребуется указать, для каких из ваших слотов доступности потребуется создать ссылку.

Это можно сделать, добавив поле linkout_required_reason со значением PAYMENT_REQUIRED .

Определение причины отключения 

message Availability {
  // ..
  LinkoutRequiredReason linkout_required_reason = 19;
}

  // The reason why a slot requires a linkout. Currently only used for Dining
  // Reservations Payment Redirect Partners.
  enum LinkoutRequiredReason {
    // Default value: Do not use, equates to unknown.
    LINKOUT_REQUIRED_REASON_UNSPECIFIED = 0;
    // Slot requires payment in the partner platform to be booked.
    PAYMENT_REQUIRED = 1;
  }

Пример определения причины сбоя 

{
  "metadata": {
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "shard_number": 0,
    "total_shards": 1,
    "nonce": "11203880",
    "generation_timestamp": 1543875200
  },
  "service_availability": [
    {
      "availability": [
        {
          "merchant_id": "dining-A",
          "service_id": "reservation",
          "linkout_required_reason": "PAYMENT_REQUIRED",
          "start_sec": 1535853600,
          "duration_sec": 2700,
          "spots_total": 2,
          "spots_open": 2,
          "resources": {
            "room_id": "A-dining-room",
            "room_name": "Dining Room",
            "party_size": 2
          }
        }
      ]
    }
  ]
}

4. Проверьте поля в Центре действий.

После успешной отправки ваших данных и отсутствия ошибок в истории ленты, вы можете проверить поля, выполнив следующие шаги.

Шаблон URL-адреса в программе просмотра инвентаря

Определение шаблона URL-адреса можно найти в разделе «Услуги» в представлении ассортимента продавца. Шаблон находится в разделе «Фрагмент фида». Более подробную информацию о представлении продавца и услуги см. в разделе «Представление ассортимента ».

Рисунок 1: Пример поиска URL-адреса в центре уведомлений.

Причина отключения ссылки в окне просмотра доступности.

Поле linkout_required_reason можно найти при просмотре конкретного временного интервала доступности в разделе «Просмотр доступности» .

Рисунок 1: Пример поиска URL-адреса в центре уведомлений.