Configurer les remises automatiques

Suivez ces instructions pour intégrer le jeton de prix.

Structure des jetons

Les jetons JWT contiennent deux objets JSON : l'en-tête et la charge utile.

En-tête

---

{

"alg": "ES256",

"typ": "JWT"

}

---

Les en-têtes des jetons générés par Google comportent deux champs :

• alg : algorithme utilisé. La valeur est toujours "ES256".
• typ : type de contenu. La valeur est toujours "JWT".

Si l'en-tête du jeton contient d'autres champs ou que les valeurs des champs diffèrent de celles décrites ci-dessus, le jeton doit être refusé.

Charge utile

---

{

"exp": 1571673600,

"o": "tddy123uk",

"m": "140301646",

"p": 21.99,

"c": "€"

}

---

La charge utile comprend les champs suivants :

• exp : délai d'expiration exprimé en heures Unix. Si le jeton a expiré, il doit être refusé.
• o : ID de l'offre, qui permet de vérifier que la page de destination correspond au produit. Si ce n'est pas le cas, le jeton doit être refusé.
• m : ID du marchand. Si l'ID du marchand ne correspond pas, le jeton doit être refusé.
• p : prix réduit.
• c : devise (en majuscules).

Intégration du jeton

Les informations exactes concernant l'intégration du jeton dépendent de la bibliothèque utilisée, mais à un niveau avancé, trois étapes sont nécessaires : décoder et valider les signatures, valider les champs et intégrer le prix.

Décodage et validation des signatures
Le jeton encodé en Base64URL est transmis dans le paramètre de requête d'URL pv2 :

La plupart des bibliothèques regroupent le décodage et la validation des signatures en une seule fonction dans laquelle "token", "ES256" (algorithme) et "public key" constituent des entrées, et "token_body" est le résultat :

Clé publique de validation :

La clé ci-dessous est destinée à tous les utilisateurs des remises automatiques et n'expire pas.

Validation des champs

Si la bibliothèque sélectionnée accepte la clé et l'algorithme à l'étape précédente, et qu'elle impose leur utilisation malgré les options d'en-tête, il n'est pas nécessaire de procéder à d'autres vérifications des en-têtes. Dans le cas contraire, vous devez vous assurer que les champs d'en-tête respectent les consignes ci-dessus. Pour en savoir plus, consultez les bonnes pratiques courantes concernant les jetons Web JSON.

Quelle que soit la bibliothèque utilisée, les champs o, m et p doivent être validés en fonction des données du marchand. S'ils ne leur correspondent pas, le jeton doit être refusé afin que les clients ne puissent pas le copier sur tous les produits et/ou marchands. Le marchand peut vérifier le champ exp et refuser le jeton s'il a expiré, mais ce n'est pas obligatoire.

Intégration du prix
Si tous les champs sont valides et que le jeton n'a pas expiré, le marchand doit utiliser le prix indiqué dans le champ p.

Vous pouvez utiliser la fonctionnalité du bon de réduction existante pour proposer une réduction sur le prix si celui-ci remplit les conditions indiquées sur cette page. Plus précisément, le prix affiché sur la page de destination doit correspondre à celui du jeton. Il ne suffit pas d'ajouter la remise sur la page de paiement.

Tests
Une fois l'intégration terminée, elle est testée en trois étapes :

• Tests fonctionnels (effectués par le marchand)
• Validation des clés (par le marchand à l'aide du jeton fourni par Google)
• Tests de bout en bout (effectués par Google)

Tests fonctionnels
Le moyen le plus simple d'effectuer les tests pendant et après le développement consiste à générer une paire de clés temporaire. Vous avez ainsi un contrôle total sur les jetons. Vous pouvez générer une paire de clés valide à l'aide de cette commande :

Les jetons peuvent être générés à l'aide de jwt.io ou d'outils similaires utilisant l'algorithme ES256.

Validation des clés
Pour confirmer que les clés de production sont bien configurées, des jetons signés sont disponibles dans Merchant Center lors de l'intégration (exemples d'URL).