Paiements standards Google: mode de paiement par carte

Présentation

L'API Card FOP (Form of Payment) accepte les paiements effectués via les fiches standards. Il peut s'agir de cartes de crédit ou de débit. Il existe à la fois un seul et flux de messages double fourni pour les paiements.

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 par réservation

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

L'intégrateur de paiement met en œuvre

Google implémente

Pour en savoir plus sur la capture de réserve, consultez cette guide détaillé.

Flux de virements

Le flux de transfert d'argent est un flux de messages unique quels fonds sont directement retenus. Le flux se compose d'une seule méthode est implémentée par l'intégrateur de paiement nommé Capture. Cette méthode vérifie les fonds disponibles de manière synchrone et capture les fonds en cas de réussite.

L'intégrateur de paiement met en œuvre

Google implémente

Pour plus d'informations sur les virements, consultez cette guide détaillé.

Processus de remboursement

Le parcours de remboursement permet de renvoyer des fonds qui étaient auparavant capturées via le flux de capture de réserve ou parcours de virement.

L'intégrateur de paiement met en œuvre

Google implémente

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

Flux de contestation

La procédure de contestation. est utilisée pour informer Google des contestations et des rejets de débit pour lesquels le client demande un remboursement. Tous les appels implique le transfert d'argent, mais ce flux peut être utilisé pour restituer des fonds à un client, ou de les inverser et de les renvoyer à Google. Ce flux peut être utilisé dans en plus du flux de signalement des fraudes, mais pas n'incluent pas nécessairement la fraude.

Google implémente

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

Flux de signalement des fraudes

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

Google implémente

Pour en savoir plus sur le signalement de fraudes, consultez cette guide détaillé.