MCP Tools Reference: paydeveloper.googleapis.com

Ferramenta: create_google_pay_integration

Cria uma integração do Google Pay para um comerciante específico. Essa operação exige que o usuário tenha aceitado os Termos de Serviço do Business Console e da API Google Pay. Não é necessário verificar isso de forma preventiva. Se eles não tiverem sido aceitos, a chamada de função vai falhar, e a mensagem de erro vai conter os URLs específicos dos Termos de Serviço que precisam ser aceitos. Se isso acontecer, apresente os URLs ao usuário para aceitação e peça para ele tentar de novo depois de aceitar. Siga esta sequência para interagir com o usuário ANTES de chamar a ferramenta: 1. Primeiro, peça ao usuário o item de integração. Por enquanto, apenas a integração com a Web é compatível. - Pergunte o URL do site. # - Se o item de integração for "Integração de app", peça o nome do pacote do app Android. 2. Em seguida, pergunte ao usuário o tipo de integração: - Peça para ele escolher "Gateway" se usar um dos provedores de serviços de pagamento (PSP) compatíveis (https://developers.google.com/pay/api#participating-processors). Caso contrário, escolha "Direta". 3. Para TODOS os tipos de integração (direta ou gateway): - Peça ao usuário para fazer upload de capturas de tela (máximo de 1 MB) do fluxo de compra integrado à API Google Pay. O fluxo de compra precisa ser revisado e aprovado antes de receber acesso total de produção. Exemplos: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - Você PRECISA pedir ao usuário para fornecer cinco capturas de tela de apoio. Peça UM POR UM para garantir o mapeamento correto. Use APENAS as descrições de enumeração fáceis de usar ao fazer perguntas. 4. Se o tipo de integração for "Direta": - Você TAMBÉM PRECISA pedir ao usuário que forneça o documento de atestado do PCI em formato PDF. Use APENAS a descrição do enum fácil de usar ao perguntar. 5. Para cada arquivo fornecido, peça ao usuário para informar o caminho ou o nome do documento, se ele estiver no diretório atual. Mapeie para o DocumentType correto e defina o campo "name" como um nome descritivo (por exemplo, item_selection.png ou pci_attestation.pdf) na solicitação. Não chame essa ferramenta até tentar coletar os documentos necessários para o tipo de integração selecionado.

O exemplo a seguir demonstra como usar curl para invocar a ferramenta create_google_pay_integration MCP.

Solicitação 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
}'

Esquema de entrada

Mensagem de solicitação para "CreateGooglePayIntegration".

CreateGooglePayIntegrationRequest

Representação JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
Campos
merchantId

string

Obrigatório. O ID do comerciante para o qual adicionar a integração do Google Pay.
googlePayIntegration

object (GooglePayIntegration)

Obrigatório. A integração do Google Pay a ser criada.

GooglePayIntegration

Representação 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.
}
Campos
integrationState

enum (IntegrationState)

Apenas saída. O estado da integração do Google Pay do comerciante.
createTime

string (Timestamp format)

Apenas saída. Quando o recurso de integração foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Apenas saída. Quando o recurso de integração foi atualizado pela última vez.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

Obrigatório. O tipo de integração do Google Pay.
integrationDocuments[]

object (IntegrationDocument)

Obrigatório. Somente entrada. Os documentos de integração do Google Pay.
Campo de união item. O item de integração. Uma delas precisa ser definida. item pode ser apenas de um dos tipos a seguir:
webDomain

string

O domínio da Web do comerciante.
androidAppPackage

string

O nome do pacote do app Android do comerciante.

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799 (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999 (inclusive).

IntegrationDocument

Representação JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
Campos
name

string

Obrigatório. O nome do documento.
data

string (bytes format)

Obrigatório. Os dados do documento.

Uma string codificada em base64.
documentType

enum (DocumentType)

Obrigatório. O tipo do documento.
mimeType

enum (MimeType)

Obrigatório. O tipo MIME do documento.

IntegrationState

O estado de integração do Google Pay de um domínio da Web ou app Android de um comerciante.

Tipos enumerados
INTEGRATION_STATE_UNSPECIFIED O estado da integração não foi especificado.
NOT_STARTED Esse estado é para quando o app Android está associado ao desenvolvedor (na Google Play Store) e ele não iniciou nenhum processo de integração.
INCOMPLETE O desenvolvedor ainda não enviou a integração para revisão, e ela também não está concluída (por exemplo, faltam documentos comprobatórios).
READY_FOR_REVIEW O desenvolvedor ainda não enviou a integração para análise, mas ela está pronta (por exemplo, os documentos de suporte foram enviados).
UNDER_REVIEW O pedido de ativação da integração está aguardando análise do administrador.
NEED_INFO A integração precisa de mais informações do administrador da gTech durante a análise.
ACTIVE A integração está ativa no momento.
DELETED A integração é excluída pelo comerciante.
REJECTED A integração é rejeitada.

IntegrationType

O tipo de integração do Google Pay.

Tipos enumerados
INTEGRATION_TYPE_UNSPECIFIED O tipo de integração não foi especificado.
DIRECT_INTEGRATION O tipo de integração é direta.
PAYMENT_SERVICE_PROVIDER O tipo de integração é provedor de serviços de pagamento.

DocumentType

O tipo de um documento.

Tipos enumerados
DOCUMENT_TYPE_UNSPECIFIED O tipo de documento não foi especificado.
ITEM_SELECTION_SCREENSHOT Quando um usuário está navegando por um item ou serviço.
PRE_PURCHASE_SCREENSHOT Quando um usuário está pronto para fazer uma compra.
PAYMENT_METHOD_SCREENSHOT Quando um usuário seleciona o Google Pay como forma de pagamento.
PAYMENT_INFO_SCREENSHOT Quando um usuário vê as informações de pagamento salvas no Google Pay. Dica: o Android não permite tirar uma captura de tela dessa tela. Por isso, tire uma foto dela usando outro dispositivo.
POST_PURCHASE_SCREENSHOT Quando um usuário faz uma compra.
PCI_ATTESTATION_DOCUMENT Documento de atestado de PCI em formato PDF.

MimeType

O tipo MIME de um documento.

Tipos enumerados
MIME_TYPE_UNSPECIFIED O tipo MIME não foi especificado.
JPEG O tipo MIME é JPEG.
PNG O tipo MIME é PNG.
WEBP O tipo MIME é WEBP.
PDF O tipo MIME é PDF.

Esquema de saída

Mensagem de resposta para "CreateGooglePayIntegration".

CreateGooglePayIntegrationResponse

Representação JSON 
{
  "integrationState": enum (IntegrationState)
}
Campos
integrationState

enum (IntegrationState)

O estado de integração do Google Pay.

IntegrationState

O estado de integração do Google Pay de um domínio da Web ou app Android de um comerciante.

Tipos enumerados
INTEGRATION_STATE_UNSPECIFIED O estado da integração não foi especificado.
NOT_STARTED Esse estado é para quando o app Android está associado ao desenvolvedor (na Google Play Store) e ele não iniciou nenhum processo de integração.
INCOMPLETE O desenvolvedor ainda não enviou a integração para revisão, e ela também não está concluída (por exemplo, faltam documentos comprobatórios).
READY_FOR_REVIEW O desenvolvedor ainda não enviou a integração para análise, mas ela está pronta (por exemplo, os documentos de suporte foram enviados).
UNDER_REVIEW O pedido de ativação da integração está aguardando análise do administrador.
NEED_INFO A integração precisa de mais informações do administrador da gTech durante a análise.
ACTIVE A integração está ativa no momento.
DELETED A integração é excluída pelo comerciante.
REJECTED A integração é rejeitada.

Anotações de ferramentas

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ❌