MCP Tools Reference: paydeveloper.googleapis.com

Araç: create_google_pay_integration

Belirli bir satıcı için Google Pay entegrasyonu oluşturur. Bu işlem için kullanıcının İşletme Konsolu Hizmet Şartları'nı ve Google Pay API Hizmet Şartları'nı kabul etmiş olması gerekir. Bunları önceden kontrol etmeniz gerekmez. Kabul edilmemişse araç çağrısı başarısız olur ve hata mesajında kabul edilmesi gereken belirli Hizmet Şartları URL'leri yer alır. Bu durumda, URL'leri kullanıcıya kabul etmesi için gösterin ve kabul edildikten sonra tekrar denemesini isteyin. Aracı çağırmadan ÖNCE kullanıcıyla etkileşim kurmak için şu sırayı izleyin: 1. Öncelikle kullanıcıdan entegrasyon öğesini isteyin (Şu an için yalnızca web entegrasyonu desteklenmektedir). - Web sitesinin URL'sini isteyin. # - Entegrasyon öğesi uygulama entegrasyonuysa Android uygulama paketi adını isteyin. 2. Ardından, kullanıcıya entegrasyon türünü sorun: - Kullanıcıya, desteklenen ödeme hizmeti sağlayıcılarımızdan (PSP'ler: https://developers.google.com/pay/api#participating-processors) birini kullanıyorsa Gateway'i, aksi takdirde Direct'i seçmesini söyleyin. 3. TÜM entegrasyon türleri (Doğrudan veya Ağ Geçidi) için: - Kullanıcıya, Google Pay API ile entegre edilmiş satın alma sürecinin ekran görüntülerini (en fazla 1 MB) yüklemesini söyleyin. Tam üretim erişimi verilmeden önce satın alma süreçlerinin incelenip onaylanması gerekir. Örnekler: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - Kullanıcıdan 5 destekleyici ekran görüntüsü sağlamasını İSTEMELİSİNİZ. Doğru eşleme için bunları TEK TEK isteyin. Soru sorarken YALNIZCA kullanıcı dostu enum açıklamalarını kullanın. 4. Entegrasyon türü Doğrudan ise: - KULLANICIDAN PCI onay belgesini PDF biçiminde sağlamasını İSTEMELİSİNİZ. Soru sorarken YALNIZCA kullanıcı dostu enum açıklamasını kullanın. 5. Sağlanan her dosya için kullanıcıdan, geçerli dizindeyse belge yolunu veya adını vermesini isteyin. İsteği doğru DocumentType ile eşleyin ve ad alanını açıklayıcı bir adla (ör. item_selection.png veya pci_attestation.pdf) ayarlayın. Seçilen entegrasyon türü için gerekli belgeleri toplamayı denemeden bu aracı çağırmayın.

Aşağıdaki örnekte, create_google_pay_integration 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": "create_google_pay_integration",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

CreateGooglePayIntegration için istek mesajı.

CreateGooglePayIntegrationRequest

JSON gösterimi 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
Alanlar
merchantId

string

Zorunlu. Google Pay entegrasyonunun ekleneceği satıcının satıcı kimliği.
googlePayIntegration

object (GooglePayIntegration)

Zorunlu. Oluşturulacak Google Pay entegrasyonu.

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ı.
androidAppPackage

string

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

Zaman damgası

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

string (int64 format)

Unix sıfır zamanı olan 1970-01-01T00:00:00Z tarihinden itibaren UTC zamanının saniyelerini 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, saniyenin negatif olmayan kesirleri. Bu alan,sürenin nanosaniye kısmıdır ve saniyenin alternatifi değildir. Kesir içeren negatif saniye değerleri,zaman içinde ileriye doğru sayılan negatif olmayan nanosaniye değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında (her iki değer de dahil) olmalıdır.

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.

Çıkış şeması

CreateGooglePayIntegration için yanıt mesajı.

CreateGooglePayIntegrationResponse

JSON gösterimi 
{
  "integrationState": enum (IntegrationState)
}
Alanlar
integrationState

enum (IntegrationState)

Google Pay entegrasyonunun entegrasyon durumu.

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.

Araç Ek Açıklamaları

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