REST Resource: inventory.partners.merchants

{
  "name": string,
  "merchantName": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "category": string,
  "numBookings30d": string,
  "taxRateBasisPoints": integer,
  "taxRate": {
    object (TaxRate)
  },
  "paymentRestrictions": {
    object (PaymentRestrictions)
  },
  "paymentOption": [
    {
      object (PaymentOption)
    }
  ],
  "paymentProcessorConfig": {
    object (PaymentProcessorConfig)
  },
  "tokenizationConfig": {
    object (TokenizationConfig)
  },
  "terms": {
    object (Terms)
  },
  "brandId": string,
  "matchingHints": {
    object (MerchantMatchingHints)
  },
  "serviceAttribute": [
    {
      object (ServiceAttribute)
    }
  ],
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}

string

Nom de la ressource marchand, au format partners/{partner_id}/merchants/{merchantId}.

string

Les champs "merchantName", "telephone", "url" et "geo" permettent de faire correspondre l'inventaire du partenaire avec les marchands déjà présents sur Google Maps. Ces informations ne sont pas affichées.

Nom du marchand.

string

Numéro de téléphone public du marchand, y compris l'indicatif du pays et de la région (par exemple, +14567891234).

string

URL du site Web public du marchand.

object (GeoCoordinates)

Coordonnées géographiques du marchand, y compris la latitude, la longitude et l'adresse.

string

Catégorie à laquelle l'entreprise appartient sur la plate-forme de l'agrégateur.

string (int64 format)

Ce champ a été abandonné.

integer (uint32 format)

Taux de taxe du marchand en points de base (un centième de 1 %). Par exemple, si le taux de taxe est de 7,5 %, ce champ doit être défini sur 750.

Si ce champ n'est pas défini ou est défini sur 0, le prix total facturé à un utilisateur pour tout service fourni par ce marchand correspond au prix exact spécifié dans le champ Service.price. Le prix du service est considéré comme étant exonéré de taxes applicables ou comme incluant déjà ces taxes. Les taxes ne sont donc pas présentées à l'utilisateur sur une ligne distincte.

Si ce champ est défini sur une valeur supérieure à 0, le prix total facturé à un utilisateur pour tout service fourni par ce marchand inclut le prix du service, ainsi que la taxe calculée à l'aide du taux fourni dans ce champ. Les fractions de la plus petite unité monétaire (par exemple, les fractions d'un centime) sont arrondies au pair le plus proche. Les taxes sont présentées à l'utilisateur sur une ligne distincte.

Ce champ a été abandonné. Veuillez plutôt utiliser taxRate.

object (TaxRate)

Taux de taxe du marchand. S'il est défini, ce champ remplace le champ taxRateBasisPoints qui a été abandonné. Lorsque le message est vide (par exemple, taxRate {}), le taux de taxe appliqué se réinitialise à zéro.

object (PaymentRestrictions)

Restrictions concernant les modes de paiement que ce marchand accepte. Si le champ n'est pas défini, le système en déduit qu'il n'y a aucune restriction.

object (PaymentOption)

Options de paiement disponibles pour ce marchand. Les services de ce marchand pourront limiter individuellement les options de paiement autorisées.

object (PaymentProcessorConfig)

Configuration d'une société de traitement des paiements tokenisée, si le marchand accepte cette option.

object (TokenizationConfig)

Configuration d'une société de traitement des paiements tokenisée, si le marchand accepte cette option.

object (Terms)

Conditions d'utilisation spécifiques au marchand présentées à l'utilisateur lors de la réservation d'un service via Réserver avec Google. En outre, les conditions d'utilisation du partenaire de l'agrégateur sont toujours présentées à l'utilisateur. Elles ne doivent donc pas être fournies ici.

string

Chaîne opaque qui identifie la marque à présenter aux utilisateurs lors de l'affichage de l'attribution du partenaire. Ce champ permet à un partenaire de fournir des marchands pour toutes les marques qu'il gère au sein d'un même flux.

Une marque comprend des propriétés à présenter aux utilisateurs, du type nom, logo, conditions d'utilisation et règles de confidentialité.

Si le partenaire n'a qu'une seule marque à présenter aux utilisateurs, ce champ n'a pas besoin d'être défini et peut être ignoré.

Si le partenaire...

n'a qu'une seule marque à présenter aux utilisateurs… --> Ignorez ce champ.

a plusieurs marques qui ont été configurées…

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

Attention : La plupart des partenaires n'ont pas besoin de définir ce champ. Si un partenaire souhaite utiliser ce champ, il doit d'abord nous contacter pour configurer des marques distinctes, y compris la marque par défaut.

object (MerchantMatchingHints)

Conseils pour aider Google à mettre un marchand en correspondance avec une adresse sur Google Maps. Remarque : la plupart des partenaires n'ont pas besoin de définir ce champ, car Google met les marchands en correspondance avec les adresses sur Google Maps à l'aide des informations fournies ci-dessus. (facultatif)

object (ServiceAttribute)

Définitions des attributs de service utilisés pour décrire les services pour ce marchand. (facultatif)

object (ActionLink)

Facultatif. Une URL d'action, en même temps que la langue associée, la liste des restrictions locales applicables, le type et une plate-forme facultative sur laquelle cette action doit être effectuée.

object (Advisement)

Facultatif. Conseils généraux d'un marchand spécifique à un utilisateur qui rejoint une liste d'attente via Réserver avec Google. La longueur des champs de texte individuels de l'avis doit être limitée à 100 octets.

object (EconomicOperator)

Facultatif. Informations sur l'opérateur économique associé à ce marchand spécifique, nécessaires pour respecter les réglementations. (facultatif)

{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}

object (CreditCardRestrictions)

Restrictions concernant les cartes de crédit que ce marchand accepte. Nous supposons que toutes les cartes de crédit sont acceptées si ce champ n'est pas défini. Notez que la liste des cartes incluses dans CreditCardType ne fait que s'allonger au fil du temps. Par conséquent, si vous ne définissez pas ce champ, vous serez obligé d'apporter des modifications à votre configuration dans le futur.

{
  "creditCardType": [
    enum (CreditCardType)
  ]
}

enum (CreditCardType)

Liste des cartes de crédit acceptées. Aucune carte de crédit n'est acceptée si non défini.

{
  "paymentOptionId": string,
  "name": string,
  "description": string,
  "price": {
    object (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}

string

Cet ID permet d'identifier cette option de paiement.

Cet identifiant s'applique de manière globale du côté de l'agrégateur. Ainsi, si vous réutilisez une valeur pour plusieurs marchands, l'utilisateur pourra payer tous ces marchands avec l'option de paiement correspondante.

Lorsque vous réutilisez un identifiant pour plusieurs marchands, la mise à jour de la valeur d'une option de paiement pour un marchand entraîne la mise à jour de toute autre option de paiement associée au même identifiant utilisée par un autre marchand. Par conséquent, afin d'éviter tout risque de comportement instable, il est recommandé que toutes les options de paiement partagent le même identifiant et qu'elles soient toujours mises à jour avec des valeurs identiques.

string

Nom de l'option de paiement. Peut être présenté à l'utilisateur.

string

Description de l'option de paiement. Peut être présenté à l'utilisateur.

object (Price)

Prix de l'option de paiement.

object (TaxRate)

Taux de taxe associé à cette option de paiement. Si ce champ est défini, il remplace le champ taxRate inclus dans "Merchant" ou "Service". Lorsque le message est vide (par exemple, taxRate {}), le taux de taxe appliqué se réinitialise à zéro.

enum (PaymentOptionType)

Type associé à cette option de paiement. À usage unique pour les visites, à usages multiples pour les packs et à usage illimité pour les abonnements.

string (int64 format)

Nombre de sessions pour lesquelles cette option de paiement peut être utilisée. Valable seulement pour les séances/packs multiples, où la valeur doit être supérieure à 1.

object (TimeRange)

L'option de paiement peut être achetée au cours de cet intervalle.

object (TimeRange)

L'option de paiement peut être utilisée au cours de cet intervalle (tarif spécial pour le mois de janvier 2017, par exemple). Si ce champ est défini, il remplace les champs "validDuration" et "activationType".

string (Duration format)

Durée de validité de l'option de paiement (par exemple, abonnement de 30 jours).

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

enum (ActivationType)

Définit la manière dont est déterminée la date de début de validité de cette option de paiement.

object (UserPurchaseRestriction)

Définit une limite concernant les utilisateurs pouvant acheter cette option de paiement. Peut être utilisé pour limiter une option de paiement promotionnelle à un sous-ensemble d'utilisateurs. Si ce champ n'est pas défini, nous en déduisons que tous les utilisateurs sont éligibles.

{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}

boolean

Option de paiement réservée aux utilisateurs n'ayant jamais effectué d'achat auprès du marchand en question.

boolean

Option de paiement réservée aux utilisateurs n'ayant jamais acheté l'option de paiement en question auparavant.

{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}

enum (Processor)

Définit la société partenaire de traitement des paiements à laquelle cette configuration s'applique.

string

Clé utilisée pour identifier ce marchand auprès de la société de traitement des paiements.

Pour Stripe, consultez la page https://stripe.com/docs/dashboard#api-keys. Pour Braintree, consultez la page https://articles.braintreepayments.com/control-panel/important-gateway-credentials.

string

Numéro de version de l'API envoyé à la société de traitement des paiements en même temps que toute demande de paiement.

{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}

map (key: string, value: string)

Une configuration de tokenisation comporte généralement un paramètre tokenizationParameter dont la clé est "gateway" et dont la valeur est le nom de la société de traitement des paiements.

Les autres paramètres dépendent du processeur. Pour en savoir plus, consultez la documentation Google Pay.

Exemple avec Braintree : tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" }

Exemple avec Stripe : tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" }

Exemple avec Adyen : tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" }

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

enum (BillingInformationFormat)

Incluez les informations bancaires de l'utilisateur dans le jeton de paiement, telles que saisies dans Google Pay en même temps que leur mode de paiement (voir ci-dessus). Si vous laissez ce champ vide, le système en déduit que la valeur est MIN.

{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}

string

URL facultative vers les conditions d'utilisation.

string

Texte à afficher auprès de l'utilisateur. Pour les nouvelles intégrations, utilisez localizedText ci-dessous.

object (Text)

Texte localisé à afficher auprès de l'utilisateur.

{
  "placeId": string
}

string

ID du lieu dans la base de données Google Adresses et sur Google Maps. Pour en savoir plus sur les identifiants de lieu, consultez la page https://developers.google.com/places/web-service/place-id.

{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}

string

Identifiant qui définit cet attribut de service de manière unique parmi tous les autres attributs de service associés au même marchand (par exemple, "account-type").

string

Nom de cet attribut, tel qu'il sera présenté à l'utilisateur (par exemple "Type de compte").

object (Value)

Toutes les valeurs possibles pour cet attribut du service.

{
  "valueId": string,
  "valueName": string
}

string

Identifiant qui définit cette valeur du service de manière unique parmi toutes les autres valeurs associées au même marchand (par exemple, "personal").

string

Nom de la valeur, tel qu'il sera présenté à l'utilisateur (par exemple, "Personnel").

{
  "text": {
    object (Text)
  }
}

object (Text)

Message personnalisé à afficher pour l'utilisateur lors de la réservation via Réserver avec Google.

{
  "text": {
    object (Text)
  }
}

object (Text)

Obligatoire. Nom, adresse, numéro de téléphone et adresse e-mail de l'opérateur économique, défini comme le fabricant, le représentant autorisé, l'importateur, le distributeur, le prestataire de services de traitement ou toute autre personne physique ou morale soumise à des obligations liées à la fabrication de produits, à leur mise à disposition ou à leur mise en service. Représentation sous forme de chaîne de forme libre de l'opérateur économique. Ces informations peuvent être mises en forme à l'aide de " " et de "\n".