MCP Tools Reference: paydeveloper.googleapis.com

Araç: list_google_pay_integrations

Belirli bir satıcı kimliğiyle ilişkili tüm Google Pay entegrasyonlarının mevcut durumunu ve yapılandırma ayrıntılarını döndürür. Entegrasyon ve belge incelemelerinin durumu hakkında anında geri bildirim sağlar. Ayrıca, kullanıcıyı entegrasyonun Google Pay ve Cüzdan Konsolu'nda (https://pay.google.com/business/console/) oluşturulabileceği/güncellenebileceği konusunda bilgilendirmeniz ZORUNLUDUR.

Aşağıdaki kod örneğinde, list_google_pay_integrations MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
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
}'

Giriş Şeması

Belirli bir satıcı için Google Pay entegrasyonlarını listeleme isteği mesajı.

ListGooglePayIntegrationsRequest

JSON gösterimi 
{
  "merchantId": string
}
Alanlar
merchantId

string

Zorunlu. Entegrasyonların listeleneceği satıcı kimliği.

Çıkış şeması

Google Pay entegrasyonlarını listelemek için yanıt mesajı.

ListGooglePayIntegrationsResponse

JSON gösterimi 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
Alanlar
googlePayIntegrations[]

object (GooglePayIntegration)

Satıcının Google Pay entegrasyonları.

GooglePayIntegration

JSON gösterimi 
{
  "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.
}
Alanlar
integrationState

enum (IntegrationState)

Yalnızca çıkış. Satıcının Google Pay entegrasyon durumu.
createTime

string (Timestamp format)

Yalnızca çıkış. Entegrasyon kaynağının oluşturulma zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Yalnızca çıkış. Entegrasyon kaynağının son güncellenme tarihi.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

Zorunlu. Google Pay entegrasyonunun entegrasyon türü.
integrationDocuments[]

object (IntegrationDocument)

Zorunlu. Yalnızca giriş. Google Pay entegrasyonunun entegrasyon dokümanları.
item birleşik alanı. Entegrasyon öğesi. Bunlardan biri ayarlanmalıdır. item aşağıdakilerden yalnızca biri olabilir:
webDomain

string

Satıcının web alan adı.
androidAppPackage

string

Satıcının Android uygulama paketinin adı.

Zaman damgası

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Unix Epoch 1970-01-01T00:00:00Z'den bu yana geçen UTC süresini saniye cinsinden gösterir. -62135596800 ile 253402300799 arasında (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir) olmalıdır.
nanos

integer

Nanosaniye çözünürlüğünde, negatif olmayan saniyenin kesirleri. Bu alan, saniyelere alternatif olarak değil, sürenin nanosaniye kısmını belirtmek için kullanılır. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında olmalıdır (bu değerler dahil).

IntegrationDocument

JSON gösterimi 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
Alanlar
name

string

Zorunlu. Belgenin adı.
data

string (bytes format)

Zorunlu. Belgenin verileri.

Base64 kodlu bir dize.
documentType

enum (DocumentType)

Zorunlu. Belgenin türü.
mimeType

enum (MimeType)

Zorunlu. Belgenin MIME türü.

IntegrationState

Bir satıcının web alanının veya Android uygulamasının Google Pay entegrasyon durumu.

Sıralamalar
INTEGRATION_STATE_UNSPECIFIED Entegrasyon durumu belirtilmemiş.
NOT_STARTED Bu durum, Android uygulaması geliştiriciyle ilişkilendirildiğinde (Play Store'da) ve geliştirici uygulama için herhangi bir entegrasyon sürecini başlatmadığında geçerlidir.
INCOMPLETE Geliştirici, entegrasyonu henüz incelemeye göndermedi ve entegrasyon tamamlanmadı (ör. destekleyici belgeler eksik).
READY_FOR_REVIEW Geliştirici, entegrasyonu henüz incelemeye göndermedi ancak incelemeye hazır (ör. destekleyici belgeler yüklendi).
UNDER_REVIEW Entegrasyon etkinleştirme isteği, yönetici tarafından incelenmeyi bekliyor.
NEED_INFO İnceleme sırasında entegrasyon için gTech yöneticisinden daha fazla bilgi alınması gerekir.
ACTIVE Entegrasyon şu anda etkin.
DELETED Entegrasyon, satıcı tarafından silinmiş olabilir.
REJECTED Entegrasyon reddedilir.

IntegrationType

Google Pay entegrasyonunun entegrasyon türü.

Sıralamalar
INTEGRATION_TYPE_UNSPECIFIED Entegrasyon türü belirtilmedi.
DIRECT_INTEGRATION Entegrasyon türü doğrudan entegrasyondur.
PAYMENT_SERVICE_PROVIDER Entegrasyon türü, ödeme hizmeti sağlayıcıdır.

DocumentType

Belgenin türü.

Sıralamalar
DOCUMENT_TYPE_UNSPECIFIED Belge türü belirtilmemiş.
ITEM_SELECTION_SCREENSHOT Kullanıcı bir öğeye veya hizmete göz atarken
PRE_PURCHASE_SCREENSHOT Kullanıcı nihayet satın alma işlemi yapmaya hazır olduğunda
PAYMENT_METHOD_SCREENSHOT Kullanıcılar ödeme yöntemi olarak Google Pay'i seçtiğinde
PAYMENT_INFO_SCREENSHOT Kullanıcıya Google Pay'e kaydettiği ödeme bilgileri gösterildiğinde İpucu: Android, bu ekranın görüntüsünü almanıza izin vermez. Bu nedenle, başka bir cihaz kullanarak ekranın fotoğrafını çekin.
POST_PURCHASE_SCREENSHOT Kullanıcı başarılı bir satın alma işlemi yaptığında.
PCI_ATTESTATION_DOCUMENT PDF biçiminde PCI onay belgesi.

MimeType

Belgenin MIME türü.

Sıralamalar
MIME_TYPE_UNSPECIFIED MIME türü belirtilmedi.
JPEG MIME türü JPEG'dir.
PNG MIME türü PNG olmalıdır.
WEBP MIME türü WEBP olmalıdır.
PDF MIME türü PDF olmalıdır.

Araç Ek Açıklamaları

Araç açıklamaları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilmeyen olarak değerlendirir ancak onay isteminin kullanıcıya ne zaman gönderileceğine karar vermek için kullanılabilirler.

Başlık dizesinin yanı sıra aşağıdaki Boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğruysa araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğruysa araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğruysa aynı bağımsız değişkenlerle aracı tekrar tekrar çağırmanın ortamı üzerinde ek bir etkisi olmaz. Varsayılan: false.
  • openWorldHint: Doğruysa araç, harici öğelerden oluşan bir "açık dünya" ile etkileşim kurabilir. Yanlışsa araç yalnızca dahili öğelerle etkileşim kurabilir. Örneğin, bir web arama aracı açık dünya olurken bir bellek aracı açık dünya olmaz.

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌