MCP Tools Reference: paydeveloper.googleapis.com

Strumento: create_google_pay_integration

Crea un'integrazione di Google Pay per un commerciante specifico. Questa operazione richiede che l'utente abbia accettato i Termini di servizio della Business Console e i Termini di servizio dell'API Google Pay. Non è necessario eseguire controlli preventivi. Se non sono stati accettati, la chiamata allo strumento non andrà a buon fine e il messaggio di errore conterrà gli URL specifici dei Termini di servizio che devono essere accettati. In questo caso, presenta gli URL all'utente per l'accettazione e chiedigli di riprovare una volta accettati. Segui questa sequenza per interagire con l'utente PRIMA di chiamare lo strumento: 1. Innanzitutto, chiedi all'utente l'elemento di integrazione (al momento è supportata solo l'integrazione web). - Chiedi l'URL del sito web. # - Se l'elemento di integrazione è l'integrazione dell'app, chiedi il nome del pacchetto dell'app per Android. 2. Poi, chiedi all'utente il tipo di integrazione: - Digli di scegliere Gateway se utilizza uno dei nostri fornitori di servizi di pagamento (PSP) supportati: https://developers.google.com/pay/api#participating-processors, altrimenti scegli Diretto. 3. Per TUTTI i tipi di integrazione (diretta o gateway): - Chiedi all'utente di caricare screenshot (max 1 MB) del percorso di acquisto integrato con l'API Google Pay. Il loro percorso di acquisto deve essere esaminato e approvato prima di poter ottenere l'accesso completo in produzione. Esempi: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - DEVI chiedere all'utente di fornire 5 screenshot a supporto. Chiedili UNO ALLA VOLTA per garantire una mappatura corretta. Quando fai una domanda, utilizza SOLO le descrizioni delle enumerazioni di facile utilizzo. 4. Se il tipo di integrazione è Direct: - Devi anche chiedere all'utente di fornire il documento di attestazione PCI in formato PDF. Quando fai una domanda, utilizza SOLO la descrizione dell'enumerazione di facile utilizzo. 5. Per ogni file fornito, chiedi all'utente di indicare il percorso o il nome del documento se si trova nella directory corrente. Mappalo al DocumentType corretto e imposta il campo del nome su un nome descrittivo (ad es. item_selection.png o pci_attestation.pdf) nella richiesta. Non chiamare questo strumento finché non hai tentato di raccogliere i documenti richiesti per il tipo di integrazione selezionato.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP create_google_pay_integration.

Curl Request 
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
}'

Schema di input

Messaggio di richiesta per CreateGooglePayIntegration.

CreateGooglePayIntegrationRequest

Rappresentazione JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
Campi
merchantId

string

Obbligatorio. L'ID commerciante del commerciante per cui aggiungere l'integrazione di Google Pay.
googlePayIntegration

object (GooglePayIntegration)

Obbligatorio. L'integrazione di Google Pay da creare.

GooglePayIntegration

Rappresentazione 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.
}
Campi
integrationState

enum (IntegrationState)

Solo output. Lo stato di integrazione di Google Pay del commerciante.
createTime

string (Timestamp format)

Solo output. La data di creazione della risorsa di integrazione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. Data e ora dell'ultimo aggiornamento della risorsa di integrazione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

Obbligatorio. Il tipo di integrazione dell'integrazione Google Pay.
integrationDocuments[]

object (IntegrationDocument)

Obbligatorio. Solo input. I documenti di integrazione dell'integrazione di Google Pay.
Campo unione item. L'elemento di integrazione. Uno di questi deve essere impostato. item può essere solo uno dei seguenti tipi:
webDomain

string

Il dominio web del commerciante.
androidAppPackage

string

Il nome del pacchetto app per Android del commerciante.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi di tempo UTC a partire dall'epoca Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori non negativi dei nanosecondi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

IntegrationDocument

Rappresentazione JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
Campi
name

string

Obbligatorio. Il nome del documento.
data

string (bytes format)

Obbligatorio. I dati del documento.

Una stringa con codifica in base64.
documentType

enum (DocumentType)

Obbligatorio. Il tipo di documento.
mimeType

enum (MimeType)

Obbligatorio. Il tipo MIME del documento.

IntegrationState

Lo stato di integrazione di Google Pay di un dominio web del commerciante o di un'app per Android.

Enum
INTEGRATION_STATE_UNSPECIFIED Lo stato dell'integrazione non è specificato.
NOT_STARTED Questo stato indica che l'app per Android è associata allo sviluppatore (sul Play Store) e che lo sviluppatore non ha avviato alcuna procedura di integrazione.
INCOMPLETE Lo sviluppatore non ha ancora inviato l'integrazione per la revisione e non è completa (ad es. mancano documenti di supporto).
READY_FOR_REVIEW Lo sviluppatore non ha ancora inviato l'integrazione per la revisione, ma è pronta (ad esempio, sono stati caricati i documenti di supporto).
UNDER_REVIEW La richiesta di attivazione dell'integrazione è in attesa di revisione da parte dell'amministratore.
NEED_INFO Durante la revisione, l'integrazione richiede ulteriori informazioni da parte dell'amministratore gTech.
ACTIVE L'integrazione è attualmente attiva.
DELETED L'integrazione viene eliminata dal commerciante.
REJECTED L'integrazione viene rifiutata.

IntegrationType

Il tipo di integrazione di un'integrazione Google Pay.

Enum
INTEGRATION_TYPE_UNSPECIFIED Il tipo di integrazione non è specificato.
DIRECT_INTEGRATION Il tipo di integrazione è l'integrazione diretta.
PAYMENT_SERVICE_PROVIDER Il tipo di integrazione è il fornitore di servizi di pagamento.

DocumentType

Il tipo di documento.

Enum
DOCUMENT_TYPE_UNSPECIFIED Il tipo di documento non è specificato.
ITEM_SELECTION_SCREENSHOT Quando un utente sta sfogliando un articolo o un servizio.
PRE_PURCHASE_SCREENSHOT Quando un utente è pronto per effettuare un acquisto.
PAYMENT_METHOD_SCREENSHOT Quando un utente seleziona Google Pay come metodo di pagamento.
PAYMENT_INFO_SCREENSHOT Quando a un utente vengono mostrati i dati di pagamento che ha salvato su Google Pay. Suggerimento: Android non ti consente di acquisire uno screenshot di questa schermata, quindi scatta una foto della schermata utilizzando un altro dispositivo.
POST_PURCHASE_SCREENSHOT Quando un utente ha effettuato un acquisto.
PCI_ATTESTATION_DOCUMENT Documento di attestazione PCI in formato PDF.

MimeType

Il tipo MIME di un documento.

Enum
MIME_TYPE_UNSPECIFIED Il tipo MIME non è specificato.
JPEG Il tipo MIME è JPEG.
PNG Il tipo MIME è PNG.
WEBP Il tipo MIME è WEBP.
PDF Il tipo MIME è PDF.

Schema di output

Messaggio di risposta per CreateGooglePayIntegration.

CreateGooglePayIntegrationResponse

Rappresentazione JSON 
{
  "integrationState": enum (IntegrationState)
}
Campi
integrationState

enum (IntegrationState)

Lo stato di integrazione dell'integrazione di Google Pay.

IntegrationState

Lo stato di integrazione di Google Pay di un dominio web del commerciante o di un'app per Android.

Enum
INTEGRATION_STATE_UNSPECIFIED Lo stato dell'integrazione non è specificato.
NOT_STARTED Questo stato indica che l'app per Android è associata allo sviluppatore (sul Play Store) e che lo sviluppatore non ha avviato alcuna procedura di integrazione.
INCOMPLETE Lo sviluppatore non ha ancora inviato l'integrazione per la revisione e non è completa (ad es. mancano documenti di supporto).
READY_FOR_REVIEW Lo sviluppatore non ha ancora inviato l'integrazione per la revisione, ma è pronta (ad esempio, sono stati caricati i documenti di supporto).
UNDER_REVIEW La richiesta di attivazione dell'integrazione è in attesa di revisione da parte dell'amministratore.
NEED_INFO Durante la revisione, l'integrazione richiede ulteriori informazioni da parte dell'amministratore gTech.
ACTIVE L'integrazione è attualmente attiva.
DELETED L'integrazione viene eliminata dal commerciante.
REJECTED L'integrazione viene rifiutata.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ❌ | Suggerimento di sola lettura: ❌ | Suggerimento open world: ❌