PaymentOptions

Options de paiement associées à une commande.

Représentation JSON 
{

  // Union field payment_option can be only one of the following:
  "googleProvidedOptions": {
    object(GoogleProvidedPaymentOptions)
  },
  "actionProvidedOptions": {
    object(ActionProvidedPaymentOptions)
  }
  // End of list of possible types for union field payment_option.
}
Champs
Champ d'union payment_option. Options de paiement. payment_option ne peut être qu'un des éléments suivants :
googleProvidedOptions

object(GoogleProvidedPaymentOptions)

Conditions requises pour le mode de paiement fourni par Google

actionProvidedOptions

object(ActionProvidedPaymentOptions)

Informations concernant un mode de paiement fourni par une action et à afficher sur le reçu.

GoogleProvidedPaymentOptions

Conditions requises pour le mode de paiement fourni par Google.

Représentation JSON 
{
  "tokenizationParameters": {
    object(PaymentMethodTokenizationParameters)
  },
  "supportedCardNetworks": [
    enum(CardNetwork)
  ],
  "prepaidCardDisallowed": boolean,
  "billingAddressRequired": boolean
}
Champs
tokenizationParameters

object(PaymentMethodTokenizationParameters)

Champ obligatoire permettant de demander un mode de paiement fourni par Google. Ces paramètres de tokenisation permettent de générer un jeton de paiement à utiliser lors des transactions. L'application doit récupérer ces paramètres auprès de sa passerelle de paiement.

supportedCardNetworks[]

enum(CardNetwork)

L'application autorise les cartes de n'importe quel réseau de cartes listé ici et utilisées pour des transactions. American Express, Visa, MC et Discover sont acceptés par défaut.

prepaidCardDisallowed

boolean

Si la valeur est "true", interdisez l'utilisation de cartes prépayées lors de la transaction.

billingAddressRequired

boolean

Si la valeur est "true", l'adresse de facturation est renvoyée.

PaymentMethodTokenizationParameters

Le partenaire DOIT spécifier les paramètres de tokenisation si les modes de paiement enregistrés par l'utilisateur auprès de Google sont utilisés pour la transaction. Le partenaire doit pouvoir obtenir ces paramètres à partir de sa propre passerelle de paiement.

Représentation JSON 
{
  "tokenizationType": enum(PaymentMethodTokenizationType),
  "parameters": {
    string: string,
    ...
  }
}
Champs
tokenizationType

enum(PaymentMethodTokenizationType)

Obligatoire.

parameters

map (key: string, value: string)

Si tokenizationType est défini sur PAYMENT_GATEWAY, la liste des paramètres doit contenir les paramètres spécifiques à la passerelle de paiement requis pour tokeniser le mode de paiement, ainsi que le paramètre portant le nom "gateway" avec la valeur définie sur l'une des passerelles compatibles, par exemple "stripe" ou "braintree". Exemple de configuration de tokenisation utilisée pour Stripe au format JSON. { "gateway" : "stripe", "stripe:publishableKey" : "pk_1234", "stripe:version" : "1.5" } Exemple de configuration de tokenisation utilisée pour Braintree au format JSON. { "gateway" : "braintree", "braintree:merchantId" : "abc" "braintree:sdkVersion" : "1.4.0" "braintree:apiVersion" : "v1" "braintree:clientKey" : "production_a12b34" "braintree:authorizationFingerprint" : "production_a12b34" } Exemple de configuration utilisée pour Adyen au format JSON. { "gateway" : "adyen", "gatewayMerchantId" : "gateway-merchant-id" } Si tokenizationType est défini sur DIRECT, les intégrateurs doivent spécifier un paramètre nommé "publicKey" qui contiendra une clé publique à courbe elliptique encodée en base64. Cette clé publique sera utilisée par Google pour chiffrer les informations de paiement. Exemple de paramètre au format JSON: { "publicKey": "base64encrypted..." }

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

ActionProvidedPaymentOptions

Conditions requises pour le mode de paiement fourni par une action.

Représentation JSON 
{
  "paymentType": enum(PaymentType),
  "displayName": string
}
Champs
paymentType

enum(PaymentType)

Type de paiement. Obligatoire.

displayName

string

Nom du mode de paiement affiché sur le reçu. Obligatoire pour les informations de paiement fournies par une action. Pour PAYMENT_CARD, il peut s'agir de "VISA-1234". Pour BANK, il peut s'agir de "Chase Verify-1234". Pour LOYALTY_PROGRAM, il peut s'agir de "points Starbuck". Pour ON_FULFILLMENT, il peut s'agir de "paiement à la livraison".