MCP Tools Reference: paydeveloper.googleapis.com

Alat: create_google_pay_integration

Membuat integrasi Google Pay untuk penjual tertentu. Operasi ini mengharuskan pengguna menyetujui Persyaratan Layanan Konsol Bisnis dan Persyaratan Layanan Google Pay API. Anda tidak perlu memeriksanya secara dini. Jika belum disetujui, panggilan alat akan gagal dan pesan error akan berisi URL Persyaratan Layanan tertentu yang harus disetujui. Jika hal ini terjadi, tampilkan URL kepada pengguna untuk disetujui, dan instruksikan mereka untuk mencoba lagi setelah disetujui. Ikuti urutan ini untuk berinteraksi dengan pengguna SEBELUM memanggil alat: 1. Pertama, minta pengguna untuk item integrasi (Saat ini hanya integrasi Web yang didukung). - Minta URL situs. # - Jika item integrasi adalah Integrasi aplikasi, minta nama paket aplikasi Android. 2. Kemudian, minta pengguna untuk memilih jenis integrasi: - Minta pengguna memilih Gateway jika mereka menggunakan salah satu Penyedia Layanan Pembayaran (PSP) yang didukung: https://developers.google.com/pay/api#participating-processors, atau pilih Langsung. 3. Untuk SEMUA jenis integrasi (Langsung atau Gateway): - Minta pengguna mengupload screenshot (maks. 1 MB) alur pembelian mereka yang terintegrasi dengan Google Pay API. Alur pembelian mereka harus ditinjau dan disetujui sebelum mereka diberi akses produksi penuh. Contoh: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. - Anda HARUS meminta pengguna untuk memberikan 5 screenshot pendukung. Minta mereka SATU PER SATU untuk memastikan pemetaan yang benar. Gunakan HANYA deskripsi enum yang mudah digunakan saat bertanya. 4. Jika jenis integrasinya adalah Langsung: - Anda JUGA HARUS meminta pengguna untuk memberikan dokumen pengesahan PCI dalam format PDF. Gunakan HANYA deskripsi enum yang mudah digunakan saat bertanya. 5. Untuk setiap file yang diberikan, minta pengguna untuk memberikan jalur atau nama dokumen jika berada di direktori saat ini. Petakan ke DocumentType yang benar dan tetapkan kolom nama ke nama deskriptif (misalnya, item_selection.png atau pci_attestation.pdf) dalam permintaan. Jangan panggil alat ini hingga Anda mencoba mengumpulkan dokumen yang diperlukan untuk jenis integrasi yang dipilih.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP create_google_pay_integration.

Permintaan 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
}'

Skema Input

Pesan permintaan untuk CreateGooglePayIntegration.

CreateGooglePayIntegrationRequest

Representasi JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
Kolom
merchantId

string

Wajib. ID penjual untuk penjual yang akan ditambahkan integrasi Google Pay-nya.
googlePayIntegration

object (GooglePayIntegration)

Wajib. Integrasi Google Pay yang akan dibuat.

GooglePayIntegration

Representasi 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.
}
Kolom
integrationState

enum (IntegrationState)

Hanya output. Status integrasi Google Pay penjual.
createTime

string (Timestamp format)

Hanya output. Waktu saat resource integrasi dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Kapan resource integrasi terakhir diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

Wajib. Jenis integrasi integrasi Google Pay.
integrationDocuments[]

object (IntegrationDocument)

Wajib. Hanya input. Dokumen integrasi untuk integrasi Google Pay.
Kolom union item. Item integrasi. Salah satu di antaranya harus ditetapkan. item hanya dapat berupa salah satu dari berikut:
webDomain

string

Domain web penjual.
androidAppPackage

string

Nama paket aplikasi Android penjual.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nano non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

IntegrationDocument

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

string

Wajib. Nama dokumen.
data

string (bytes format)

Wajib. Data dokumen.

String berenkode base64.
documentType

enum (DocumentType)

Wajib. Jenis dokumen.
mimeType

enum (MimeType)

Wajib. Jenis MIME dokumen.

IntegrationState

Status integrasi Google Pay dari domain web penjual atau aplikasi Android.

Enum
INTEGRATION_STATE_UNSPECIFIED Status integrasi tidak ditentukan.
NOT_STARTED Status ini adalah saat aplikasi Android dikaitkan dengan developer (di Google Play Store) dan developer belum memulai proses integrasi apa pun untuk aplikasi tersebut.
INCOMPLETE Developer belum mengirimkan integrasi untuk ditinjau dan integrasi juga belum selesai (misalnya, tidak ada dokumen pendukung).
READY_FOR_REVIEW Developer belum mengirimkan integrasi untuk ditinjau, tetapi integrasi sudah siap ditinjau (misalnya, dokumen pendukung telah diupload).
UNDER_REVIEW Permintaan pengaktifan integrasi sedang menunggu peninjauan oleh admin.
NEED_INFO Integrasi memerlukan informasi lebih lanjut dari admin gTech selama peninjauan.
ACTIVE Integrasi saat ini aktif.
DELETED Integrasi dihapus oleh penjual.
REJECTED Integrasi ditolak.

IntegrationType

Jenis integrasi integrasi Google Pay.

Enum
INTEGRATION_TYPE_UNSPECIFIED Jenis integrasi tidak ditentukan.
DIRECT_INTEGRATION Jenis integrasinya adalah integrasi langsung.
PAYMENT_SERVICE_PROVIDER Jenis integrasinya adalah penyedia layanan pembayaran.

DocumentType

Jenis dokumen.

Enum
DOCUMENT_TYPE_UNSPECIFIED Jenis dokumen tidak ditentukan.
ITEM_SELECTION_SCREENSHOT Saat pengguna menjelajahi item atau layanan.
PRE_PURCHASE_SCREENSHOT Saat pengguna akhirnya siap melakukan pembelian.
PAYMENT_METHOD_SCREENSHOT Saat pengguna memilih Google Pay sebagai metode pembayaran mereka.
PAYMENT_INFO_SCREENSHOT Saat pengguna melihat info pembayaran yang telah mereka simpan ke Google Pay. Tips: Android tidak akan mengizinkan Anda mengambil screenshot layar ini, jadi ambil foto layar menggunakan perangkat lain.
POST_PURCHASE_SCREENSHOT Saat pengguna telah melakukan pembelian yang berhasil.
PCI_ATTESTATION_DOCUMENT Dokumen pengesahan PCI dalam format PDF.

Jenis Mime

Jenis MIME dokumen.

Enum
MIME_TYPE_UNSPECIFIED Jenis MIME tidak ditentukan.
JPEG Jenis MIME adalah JPEG.
PNG Jenis MIME adalah PNG.
WEBP Jenis MIME adalah WEBP.
PDF Jenis MIME adalah PDF.

Skema Output

Pesan respons untuk CreateGooglePayIntegration.

CreateGooglePayIntegrationResponse

Representasi JSON 
{
  "integrationState": enum (IntegrationState)
}
Kolom
integrationState

enum (IntegrationState)

Status integrasi integrasi Google Pay.

IntegrationState

Status integrasi Google Pay dari domain web penjual atau aplikasi Android.

Enum
INTEGRATION_STATE_UNSPECIFIED Status integrasi tidak ditentukan.
NOT_STARTED Status ini adalah saat aplikasi Android dikaitkan dengan developer (di Google Play Store) dan developer belum memulai proses integrasi apa pun untuk aplikasi tersebut.
INCOMPLETE Developer belum mengirimkan integrasi untuk ditinjau dan integrasi juga belum selesai (misalnya, tidak ada dokumen pendukung).
READY_FOR_REVIEW Developer belum mengirimkan integrasi untuk ditinjau, tetapi integrasi sudah siap ditinjau (misalnya, dokumen pendukung telah diupload).
UNDER_REVIEW Permintaan pengaktifan integrasi sedang menunggu peninjauan oleh admin.
NEED_INFO Integrasi memerlukan informasi lebih lanjut dari admin gTech selama peninjauan.
ACTIVE Integrasi saat ini aktif.
DELETED Integrasi dihapus oleh penjual.
REJECTED Integrasi ditolak.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ❌ | Petunjuk Hanya Baca: ❌ | Petunjuk Dunia Terbuka: ❌