Paiements standards Google: mode de paiement par carte

Présentation

L'API Card FOP (Mode de paiement) accepte les paiements effectués à l'aide de cartes standards. Il peut s'agir de cartes de crédit ou de débit. Pour les paiements, un flux de messages unique ou double est proposé.

Concepts importants

Symboles et conventions

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

Codes temporels

Tous les codes temporels sont représentés par des millisecondes écoulées depuis l'epoch Unix en UTC.

Exemple :

  • 14 août 2010 16:30:00, 00 GMT = 1281803400000
  • 6 novembre 2007 21:37:00 MST = 1194410220000

Montants

Dans cette API, les valeurs monétaires sont représentées à l'aide d'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 micro-unités, 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. Pour faire simple, les intégrateurs ne doivent pas tenter de traiter à nouveau une requête déjà traitée. La réponse en cas de réussite du traitement doit être signalée. 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 (une réponse non HTTP 200) ne doit pas être traitée idempotemment. Ainsi, une requête qui a précédemment obtenu un code 400, lorsqu'elle est appelée une deuxième fois, ne doit pas renvoyer idempotemment la valeur 400, mais doit être réévaluée. Lors de la réévaluation, la valeur peut renvoyer un code 400 ou être traitée avec succès.

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

Flux de capture des réserves

Le flux de capture par réservation est un flux de deux messages dans lequel les fonds sont d'abord réservés, puis capturés. Pendant la réservation, aucun transfert d'argent n'est effectué. La réservation peut ensuite être annulée ou enregistrée. Le résultat final de la capture ou de l'annulation est renvoyé de manière asynchrone à Google via une notification.

L'intégrateur de paiements implémente

Google met en œuvre

Pour plus d'informations sur la capture par réserve, consultez ce guide détaillé.

Flux de virement

Le flux de transfert de fonds est un flux de messages unique par lequel les fonds sont directement capturés. Le flux est composé d'une méthode unique mise en œuvre par l'intégrateur de paiements, nommée Capture. Cette méthode vérifie de manière synchrone les fonds disponibles et capture les fonds en cas de succès.

L'intégrateur de paiements implémente

Google met en œuvre

Pour en savoir plus sur les virements, consultez ce guide détaillé.

Processus de remboursement

Le flux de remboursement permet de renvoyer les fonds précédemment collectés via le flux de capture des réserves ou le flux de transfert d'argent.

L'intégrateur de paiements implémente

Google met en œuvre

Pour en savoir plus sur les remboursements, consultez ce guide détaillé.

Procédure de contestation

Le parcours de contestation permet d'informer Google des contestations et des rejets de débit pour lesquels le client demande à être remboursé. Tous les appels n'impliquent pas de transfert d'argent, mais ce flux peut être utilisé pour renvoyer les fonds à un client, ou pour les annuler et les renvoyer à Google. Cette procédure peut être utilisée en plus du flux de signalement de fraude, mais elle n'inclut pas nécessairement la fraude.

Google met en œuvre

Pour en savoir plus sur les contestations, consultez ce guide détaillé.

Flux de signalement de fraude

Le flux de signalement de fraude permet d'informer Google d'une fraude potentielle. Ces informations n'impliquent aucun transfert d'argent et sont simplement utilisées pour informer le moteur de gestion des risques de Google de l'événement afin de réduire la fraude globale. Cela peut être accompagné d'une contestation ou d'un rejet de débit via la procédure de contestation.

Google met en œuvre

Pour en savoir plus sur le signalement des fraudes, consultez ce guide détaillé.