Method: echo

Émet un écho au clientMessage transmis.

L'objectif de cette méthode est de tester la connectivité de base entre l'intégrateur de paiement et Google.

Cette méthode peut être appelée par Google plusieurs fois par minute avec des paramètres valides ou non valides afin de vérifier que les contraintes de sécurité sont correctement maintenues. Cette méthode est également appelée "ad hoc" tant à la direction de l'intégrateur que de Google. Google n'appelle jamais cette requête plus d'une fois toutes les 10 secondes, et jamais plus de 30 fois sur une période de 15 minutes.

Voici quelques exemples de tests de contraintes de sécurité (liste non exhaustive):

  • Effectuez un test pour vous assurer que le point de terminaison de l'intégrateur de paiement ne négocie pas les suites de chiffrement faibles.
  • Effectuez un test pour vous assurer que le point de terminaison de l'intégrateur de paiement ne négocie rien d'autre que TLS 1.2
  • Effectuez un test pour vous assurer que le point de terminaison de l'intégrateur de paiement n'est pas compatible avec le protocole HTTP.
  • Effectuez un test pour vous assurer que le point de terminaison de l'intégrateur de paiement exige au moins une clé de signature PGP connue.
  • Effectuez des tests pour vous assurer que le point de terminaison de l'intégrateur de paiement accepte plusieurs signatures de clé PGP, connues et inconnues, à la fois expirées et actives.
  • Vérifiez que l'intégrateur de paiement n'accepte que l'analyse JSON stricte.

Si le point de terminaison rencontre une erreur lors du traitement de la requête, le corps de la réponse de ce point de terminaison doit être de type ErrorResponse.

Voici un exemple de requête:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "ZWNobyB0cmFuc2FjdGlvbg",
    "requestTimestamp": "1481899949606"
  },
  "clientMessage": "client message"
}

Voici un exemple de réponse:


{
  "responseHeader": {
    "responseTimestamp": "1481900013178"
  },
  "clientMessage": "client message",
  "serverMessage": "server message"
}

Requête HTTP

POST https://www.integratorhost.example.com/v1/echo

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "clientMessage": string
}
Champs
requestHeader

object (RequestHeader)

OBLIGATOIRE: en-tête commun à toutes les requêtes.
clientMessage

string

REQUIRED: message à renvoyer dans la réponse.

Corps de la réponse

Objet de réponse pour la méthode echo.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "clientMessage": string,
  "serverMessage": string
}
Champs
responseHeader

object (ResponseHeader)

OBLIGATOIRE: en-tête commun à toutes les réponses.
clientMessage

string

REQUIRED: message reçu dans la requête.
serverMessage

string

FACULTATIF: message du serveur, indépendamment de l'élément clientMessage renvoyé.