MCP Tools Reference: paydeveloper.googleapis.com

Outil : create_google_pay_integration

Crée une intégration Google Pay pour un marchand spécifique. Pour effectuer cette opération, l'utilisateur doit avoir accepté les conditions d'utilisation de la Business Console et de l'API Google Pay. Vous n'avez pas besoin de les vérifier de manière préventive. Si elles n'ont pas été acceptées, l'appel d'outil échouera et le message d'erreur contiendra les URL spécifiques des conditions d'utilisation qui doivent être acceptées. Dans ce cas, présentez les URL à l'utilisateur pour qu'il les accepte, puis demandez-lui de réessayer une fois qu'il les aura acceptées. Suivez cette séquence pour interagir avec l'utilisateur AVANT d'appeler l'outil : 1. Commencez par demander à l'utilisateur l'élément d'intégration (seule l'intégration Web est prise en charge pour le moment). - Demandez l'URL du site Web. # - Si l'élément d'intégration est une intégration d'application, demandez le nom du package d'application Android. 2. Demandez ensuite à l'utilisateur le type d'intégration : - Dites-lui de choisir "Passerelle" s'il utilise l'un de nos fournisseurs de services de paiement (PSP) compatibles (https://developers.google.com/pay/api#participating-processors), sinon de choisir "Direct". 3. Pour TOUS les types d'intégration (directe ou passerelle) : - Demandez à l'utilisateur d'importer des captures d'écran (1 Mo max) de son parcours d'achat intégré à l'API Google Pay. Leur parcours d'achat doit être examiné et approuvé avant qu'ils puissent bénéficier d'un accès en production complet. Exemples : https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - Vous DEVEZ demander à l'utilisateur de fournir cinq captures d'écran justificatives. Demandez-les UN PAR UN pour vous assurer que le mappage est correct. N'utilisez QUE les descriptions d'énumération conviviales lorsque vous posez des questions. 4. Si le type d'intégration est "Direct", vous DEVEZ également demander à l'utilisateur de fournir le document d'attestation PCI au format PDF. Lorsque vous posez une question, utilisez UNIQUEMENT la description conviviale de l'énumération. 5. Pour chaque fichier fourni, demandez à l'utilisateur de fournir le chemin d'accès ou le nom du document s'il se trouve dans le répertoire actuel. Associez-le au DocumentType approprié et définissez le champ "name" sur un nom descriptif (par exemple, "item_selection.png" ou "pci_attestation.pdf") dans la requête. N'appelez pas cet outil tant que vous n'avez pas essayé de collecter les documents requis pour le type d'intégration sélectionné.

L'exemple suivant montre comment utiliser curl pour appeler l'outil MCP create_google_pay_integration.

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": "create_google_pay_integration",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schéma d'entrée

Message de requête pour CreateGooglePayIntegration.

CreateGooglePayIntegrationRequest

Représentation JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
Champs
merchantId

string

Obligatoire. ID du marchand pour lequel ajouter l'intégration Google Pay.
googlePayIntegration

object (GooglePayIntegration)

Obligatoire. Intégration Google Pay à créer.

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.

Horodatage

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 Lorsque les informations de paiement enregistrées dans Google Pay sont affichées à l'utilisateur. 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.

Schéma de sortie

Message de réponse pour CreateGooglePayIntegration.

CreateGooglePayIntegrationResponse

Représentation JSON 
{
  "integrationState": enum (IntegrationState)
}
Champs
integrationState

enum (IntegrationState)

État de l'intégration Google Pay.

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.

Annotations d'outils

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