Paiements standards Google:

Mode de paiement pour la redirection

Présentation

Les paiements standards Google sont compatibles avec les modes de paiement basés sur la redirection. Ce mode de paiement permet aux utilisateurs de produits ou services Google de les payer dans l'interface Web d'une entité externe. De manière générale, un utilisateur qui souhaite payer des produits est initialement redirigé vers un intégrateur de paiement ou vers un émetteur disponible via un intégrateur de paiement. Si l'utilisateur est redirigé vers l'intégrateur, celui-ci doit le rediriger vers l'interface Web de l'émetteur pour finaliser l'achat. Une fois le paiement effectué, l'utilisateur est redirigé vers Google via l'intégrateur.

Google utilise deux procédures principales pour effectuer un paiement via un mode de paiement de redirection:

  1. Redirection du paiement: deux procédures différentes permettent d'initier un paiement de redirection. L'intégrateur de paiement ne doit mettre en œuvre que l'une de ces options :
  2. Terminer le parcours de redirection: une fois que l'utilisateur a effectué l'achat, l'intégrateur utilise cette procédure pour confirmer le paiement auprès de Google.

Enfin, tout le transfert d'argent entre la banque de l'intégrateur et celle de Google s'effectue au cours du flux de paiement.

Présentation du mode de paiement pour la redirection

La figure suivante présente une vue d'ensemble des flux:

Schéma de présentation du mode de paiement pour la redirection

De manière générale, pour ajouter votre service comme mode de paiement dans les produits Google, procédez comme suit:

  1. Lancez la redirection :
  2. Processus de redirection complet
  3. Procédure de remboursement
  4. Flux de paiement

Concepts et terminologie

Symboles et conventions

Les mots clés "DOIT", "DOIT", "NE DOIT PAS", "OBLIGATOIRE", "DOIT", "NE DOIT PAS", "DOIT", "NE DOIT PAS", "RECOMMANDÉ", "PEUT" et "FACULTATIF" utilisés dans ces documents doivent être interprétés tel que décrit dans le document RFC 2119.

Codes temporels

Tous les codes temporels sont exprimés en millisecondes écoulées depuis l'epoch Unix (1er janvier 1970) au format UTC.

Exemple :

  • 23 avril 2019 20:23:25 GMT = 1556051005000 millisecondes
  • 16 août 2018 12:28:35 GMT = 1534422515000 millisecondes

Montants

Dans cette API, les valeurs monétaires sont dans un format appelé "micros", la norme de Google. Les micros sont un format à précision fixe basé sur des nombres entiers. Pour représenter une valeur monétaire en micros, multipliez la valeur de la devise standard par 1 000 000.

Exemple :

  • 1,23 USD = 1 230 000 microUSD
  • 0,01 USD = 10 000 microUSD

Idempotence

Tous les appels de méthode dans cette API doivent avoir un comportement idempotent. Google relance sporadiquement les requêtes pour s'assurer que les transactions sont dans le même état des deux côtés. Les intégrateurs ne doivent pas tenter de traiter à nouveau une demande déjà traitée avec succès. La réponse en cas de réussite du traitement doit être indiquée à la place. Toutes les méthodes ont un RequestHeader commun, qui contient un requestId. Ce requestId est la clé d'idempotence de tous les appels.

Toute réponse non terminale (un succès non HTTP de type 200) ne doit pas être traitée de manière idempotente. Ainsi, une requête ayant précédemment reçu un code 400 (requête incorrecte ou condition préalable ayant échoué), lorsqu'elle est appelée une deuxième fois, ne doit pas renvoyer idempotemment la valeur 400. Elle doit donc être réévaluée. Lors de la réévaluation, la valeur peut renvoyer un code 400 ou être traitée correctement.

Pour en savoir plus sur l'idempotence, consultez ce guide détaillé.

Intégrateur

Une entreprise qui utilise la plate-forme de paiement Google pour son activité. Il peut s'agir d'une entreprise interne (propriétaire), comme YouTube ou AdWords, ou d'une entreprise externe (3P) souhaitant intégrer ses services pour fonctionner avec l'écosystème de Google.

Mode de paiement

Mode de paiement. C'est plus général qu'un instrument. Les modes de paiement Visa, MasterCard et PayPal sont tous des modes de paiement acceptés.

Instrument

Un mode de paiement donné par un client spécifique. Il peut s'agir, par exemple, de la carte de crédit d'un utilisateur ou de son compte PayPal. Un mode de paiement tokenisé pour un client spécifique est également un mode de paiement, car il s'agit d'une instance d'un mode de paiement pour ce client, stocké de manière sécurisée sur notre système.

Jeton

Représentation, sur le système de Google, du mode de paiement d'un utilisateur spécifique. Étant donné qu'il contient toutes les informations nécessaires pour effectuer un achat, un jeton est également un instrument. Il peut s'agir d'un numéro de compte dont dispose l'utilisateur auprès de son intégrateur.

Flux clés

Commencer la procédure de redirection

La première étape d'un paiement de redirection est le flux "Commencer la redirection". L'objectif du flux de type "Commencer la redirection" est de rediriger l'utilisateur, via l'intégrateur, vers l'interface Web de l'émetteur de son choix afin qu'il puisse autoriser un paiement. Lors de la redirection, Google fournit des informations de base sur la transaction à l'intégrateur, qui les transmet à son tour à l'émetteur.

Pour en savoir plus, consultez la section Commencer la redirection.

Terminer la procédure de redirection

Une fois que l'utilisateur est dans l'interface Web de l'émetteur, il doit suivre toutes les étapes nécessaires pour effectuer un paiement (ces étapes peuvent varier en fonction de l'émetteur). Lors de la procédure de redirection complète, l'émetteur doit rediriger l'utilisateur vers l'intégrateur en lui fournissant des informations sur le paiement effectué. L'intégrateur redirige ensuite l'utilisateur vers Google, en incluant les détails du paiement dans la réponse de redirection. Une fois le paiement confirmé, Google fournit les produits ou services achetés à l'utilisateur.

Pour en savoir plus, consultez la section Terminer la procédure de redirection.