Modèles d'URL pour la redirection de paiement

Lorsqu'il réserve un créneau de disponibilité avec un prix spécifique, l'utilisateur est redirigé vers votre page de réservation à l'aide d'une URL que vous avez définie. Les étapes ci-dessous vous expliquent comment procéder:

1. Définissez votre modèle d'URL.
2. Définissez votre modèle d'URL dans vos flux.
3. Activez le lien externe par créneau de disponibilité.
4. Vérifiez les champs dans le Centre d'action.

1. Définir votre modèle d'URL

Le modèle d'URI respecte la spécification de modèle d'URI de niveau 2 RFC6570 de l'IETF (Internet Engineering Task Force). Pour en savoir plus, consultez datatracker.ietf.org. Vous définissez l'URL avec des paramètres qui sont renseignés dynamiquement avec des informations concernant cette réservation. Le tableau suivant inclut les paramètres obligatoires et facultatifs disponibles pour votre modèle d'URI.

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

Valeurs disponibles pour le modèle d'URL

Paramètres du modèle	Obligatoire / Facultatif	Flux	Champ	Exemple de valeur
availability_slot_start_seconds	Obligatoire	disponibilité	start_sec	4152695841
resources_party_size	Obligatoire	availability.resources	party_size	2
availability_slot_availability_tag	Facultatif	disponibilité	availability_tag	res-123
availability_slot_duration_seconds	Facultatif	disponibilité	duration_sec	3600

Important :Nous vous recommandons de ne commencer qu'avec les paramètres obligatoires, puis d'ajouter le reste si nécessaire. Si un paramètre facultatif figure dans votre uri_template, mais qu'il n'est pas défini dans vos flux, l'expérience de lien externe ne s'affiche pas pour cet emplacement.

2. Définissez votre modèle d'URI dans votre flux.

La section suivante suppose que vous disposez d'une intégration de bout en bout en direct avec un flux de services existant. L'URL que vous avez définie sera définie dans le flux de services. La définition de ce champ est indiquée ci-dessous.

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

Remarque :Un modèle d'URI est défini pour tous les créneaux de disponibilité associés à un service. Si vous devez définir des paramètres différents pour un restaurant, vous pouvez le faire en envoyant différents services avec des modèles d'URI uniques pour chacun.

Définition du modèle d'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;
}

Exemple de définition de service

{
  "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"
          }
        ]
      }
    }
  ]
}

3. Activez le lien externe par créneau de disponibilité.

La section suivante suppose que vous disposez d'une intégration E2E active avec un flux de disponibilité existant. Une fois que vous avez défini le modèle d'URL dans votre flux de services, vous devez spécifier les créneaux de disponibilité qui seront nécessaires pour créer des liens.

Pour ce faire, ajoutez le champ linkout_required_reason avec une valeur de PAYMENT_REQUIRED.

Définition du motif de lien externe

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;
  }

Exemple de définition du motif de lien externe

{
  "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
          }
        }
      ]
    }
  ]
}

Important :Une fois cette étape terminée, les emplacements de redirection de paiement n'apparaissent que si cet emplacement dispose d'une configuration de paiement. Pour en savoir plus, consultez Spécifier les types de paiement

.

4. Vérifier les champs dans le centre d'action

Une fois vos flux envoyés et qu'aucune erreur ne s'affiche dans l'historique des flux, vous pouvez vérifier les champs en procédant comme suit.

Remarque :N'oubliez pas que le traitement du flux peut prendre entre 4 et 8 heures. Si les champs ne s'affichent pas immédiatement, vous devrez peut-être patienter plus longtemps.

Modèle d'URL dans l'outil d'affichage de l'inventaire

Vous trouverez la définition du modèle d'URL dans la section "Services" de la vue d'inventaire d'un marchand. Vous le trouverez dans la section "Extrait de flux". Pour en savoir plus sur la vue "Marchand et service", consultez Vue "Inventaire".

Figure 1:Emplacement du modèle d'URL dans le centre d'action.

Motif de la redirection dans le lecteur de disponibilité

Vous trouverez le champ linkout_reason_required lorsque vous afficherez l'espace de disponibilité spécifique dans la vue Disponibilité.

Figure 1:Emplacement du modèle d'URL dans le centre d'action.