MCP Tools Reference: paydeveloper.googleapis.com

Outil : list_google_pay_integrations

Renvoie l'état actuel et les détails de configuration de toutes les intégrations Google Pay associées à un ID de marchand spécifique. Il fournit des commentaires immédiats sur l'état de l'intégration et des révisions de documents. De plus, vous DEVEZ informer l'utilisateur que l'intégration peut être créée/modifiée dans la Google Pay & Wallet Console (https://pay.google.com/business/console/).

L'exemple de code suivant montre comment utiliser curl pour appeler l'outil MCP list_google_pay_integrations.

Requête curl 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_google_pay_integrations",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Message de requête pour lister les intégrations Google Pay pour un marchand spécifique.

ListGooglePayIntegrationsRequest

Représentation JSON 
{
  "merchantId": string
}
Champs
merchantId

string

Obligatoire. ID du marchand pour lequel lister les intégrations.

Schéma de sortie

Message de réponse pour la liste des intégrations Google Pay.

ListGooglePayIntegrationsResponse

Représentation JSON 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
Champs
googlePayIntegrations[]

object (GooglePayIntegration)

Les intégrations Google Pay du commerçant.

GooglePayIntegration

Représentation JSON 
{
  "integrationState": enum (IntegrationState),
  "createTime": string,
  "updateTime": string,
  "integrationType": enum (IntegrationType),
  "integrationDocuments": [
    {
      object (IntegrationDocument)
    }
  ],

  // Union field item can be only one of the following:
  "webDomain": string,
  "androidAppPackage": string
  // End of list of possible types for union field item.
}
Champs
integrationState

enum (IntegrationState)

Uniquement en sortie. État de l'intégration Google Pay du marchand.
createTime

string (Timestamp format)

Uniquement en sortie. Date de création de la ressource d'intégration.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Date de la dernière mise à jour de la ressource d'intégration.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

Obligatoire. Type d'intégration de l'intégration Google Pay.
integrationDocuments[]

object (IntegrationDocument)

Obligatoire. Uniquement en entrée. Documents d'intégration de Google Pay.
Champ d'union item. Élément d'intégration. L'un de ces éléments doit être défini. item ne peut être qu'un des éléments suivants :
webDomain

string

Domaine Web du marchand.
androidAppPackage

string

Nom du package d'application Android du marchand.

Code temporel

Représentation JSON 
{
  "seconds": string,
  "nanos": integer
}
Champs
seconds

string (int64 format)

Représente les secondes de l'heure UTC à partir de l'epoch Unix 1970-01-01T00:00:00Z. La valeur doit être comprise entre -62135596800 et 253402300799 inclus (ce qui correspond à 0001-01-01T00:00:00Z et 9999-12-31T23:59:59Z).
nanos

integer

Fractions de secondes non négatives avec une précision de l'ordre de la nanoseconde. Ce champ correspond à la partie en nanosecondes de la durée, et non à une alternative aux secondes. Les valeurs de secondes négatives avec des fractions doivent toujours comporter des valeurs de nanosecondes non négatives comptabilisées dans le temps. La valeur doit être comprise entre 0 et 999 999 999 inclus.

IntegrationDocument

Représentation JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
Champs
name

string

Obligatoire. Nom du document.
data

string (bytes format)

Obligatoire. Données du document.

Chaîne encodée en base64.
documentType

enum (DocumentType)

Obligatoire. Type du document.
mimeType

enum (MimeType)

Obligatoire. Type MIME du document.

IntegrationState

État de l'intégration Google Pay d'un domaine Web ou d'une application Android d'un marchand.

Enums
INTEGRATION_STATE_UNSPECIFIED L'état de l'intégration n'est pas spécifié.
NOT_STARTED Cet état s'applique lorsque l'application Android est associée au développeur (sur le Play Store) et que le développeur n'a pas encore commencé de processus d'intégration pour celle-ci.
INCOMPLETE Le développeur n'a pas encore envoyé l'intégration pour examen et elle n'est pas non plus terminée (par exemple, il manque des pièces justificatives).
READY_FOR_REVIEW Le développeur n'a pas encore envoyé l'intégration pour examen, mais elle est prête (par exemple, les pièces justificatives ont été importées).
UNDER_REVIEW La demande d'activation de l'intégration est en attente d'examen par l'administrateur.
NEED_INFO L'administrateur gTech a besoin de plus d'informations sur l'intégration lors de l'examen.
ACTIVE L'intégration est actuellement active.
DELETED L'intégration est supprimée par le marchand.
REJECTED L'intégration est refusée.

IntegrationType

Type d'intégration Google Pay.

Enums
INTEGRATION_TYPE_UNSPECIFIED Le type d'intégration n'est pas spécifié.
DIRECT_INTEGRATION Le type d'intégration est l'intégration directe.
PAYMENT_SERVICE_PROVIDER Le type d'intégration est "prestataire de services de paiement".

DocumentType

Type de document.

Enums
DOCUMENT_TYPE_UNSPECIFIED Le type de document n'est pas spécifié.
ITEM_SELECTION_SCREENSHOT Lorsqu'un utilisateur parcourt un article ou un service.
PRE_PURCHASE_SCREENSHOT Lorsqu'un utilisateur est prêt à effectuer un achat.
PAYMENT_METHOD_SCREENSHOT Lorsqu'un utilisateur sélectionne Google Pay comme mode de paiement.
PAYMENT_INFO_SCREENSHOT Lorsqu'un utilisateur voit les informations de paiement qu'il a enregistrées dans Google Pay. Conseil : Android ne vous permet pas de faire une capture d'écran de cet écran. Prenez donc une photo de l'écran avec un autre appareil.
POST_PURCHASE_SCREENSHOT Lorsqu'un utilisateur a effectué un achat.
PCI_ATTESTATION_DOCUMENT Document d'attestation PCI au format PDF.

MimeType

Type MIME d'un document.

Enums
MIME_TYPE_UNSPECIFIED Le type MIME n'est pas spécifié.
JPEG Le type MIME est JPEG.
PNG Le type MIME est PNG.
WEBP Le type MIME est WEBP.
PDF Le type MIME est PDF.

Annotations d'outils

Les annotations d'outil sont envoyées aux clients MCP pour décrire le risque de base d'un outil donné. La plupart des clients traitent ces indices comme non fiables, mais ils peuvent être utilisés pour déterminer quand un message de confirmation peut être envoyé à un utilisateur.

En plus de la chaîne de titre, les indications booléennes suivantes sont définies comme suit :

  • readOnlyHint : si la valeur est "true", l'outil ne modifie pas son environnement. Valeur par défaut : "false".
  • destructiveHint : si la valeur est "true", l'outil peut effectuer des actions destructrices. Si la valeur est "false", l'outil ne peut effectuer que des actions d'ajout. Valeur par défaut : "true".
  • idempotentHint : si la valeur est "true", appeler l'outil à plusieurs reprises avec les mêmes arguments n'aura aucun effet supplémentaire sur son environnement. Valeur par défaut : "false".
  • openWorldHint : si la valeur est "true", l'outil peut interagir avec un "monde ouvert" d'entités externes. Si la valeur est "false", l'outil ne peut interagir qu'avec des entités internes. Par exemple, un outil de recherche Web serait en monde ouvert, tandis qu'un outil de mémoire ne le serait pas.

Indication destructive : ❌ | Indication d'idempotence : ✅ | Indication de lecture seule : ✅ | Indication de monde ouvert : ❌