Method: echo

Mengulangi {i>string<i} yang dikirim dari klien.

Jika endpoint mengalami error saat memproses permintaan, respons dari endpoint ini akan berjenis ErrorResponse.

Respons kueri ini mungkin kosong jika metode ini tidak menampilkan HTTP 200. Isi respons akan kosong jika ErrorResponse dengan deskripsi yang jelas dapat digunakan untuk membantu penyerang memahami ID akun integrator pembayaran dari integrator lain. Dalam situasi ini, jika kunci penandatanganan tidak cocok, ID integrator pembayaran tidak ditemukan, atau kunci enkripsi tidak diketahui, metode ini akan menampilkan HTTP 404 dengan isi kosong. Jika tanda tangan permintaan dapat diverifikasi, informasi tambahan terkait error tersebut akan ditampilkan dalam isi respons.

Contoh permintaan terlihat seperti ini:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 2
    },
    "requestId": "G1MQ0YERJ0Q7LPM",
    "requestTimestamp": {
      "epochMillis": "1481899949606"
    },
    "paymentIntegratorAccountId": "InvisiCashUSA_USD"
  },
  "clientMessage": "Client echo message"
}

Contoh respons sukses terlihat seperti berikut:


{
  "responseHeader": {
    "responseTimestamp": {
      "epochMillis":"1481899950236"
    }
  },
  "clientMessage": "Client echo message",
  "serverMessage": "Debug ID 12345"
}

Permintaan HTTP

POST https://vgw.googleapis.com/secure-serving/gsp/v2/echo/:PIAID

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "clientMessage": string
}
Kolom
requestHeader

object (RequestHeader)

WAJIB: Header umum untuk semua permintaan.
clientMessage

string

REQUIRED: Pesan yang akan digemakan dalam respons.

Isi respons

Objek respons untuk metode echo.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "clientMessage": string,
  "serverMessage": string
}
Kolom
responseHeader

object (ResponseHeader)

WAJIB: Header umum untuk semua respons.
clientMessage

string

WAJIB: Pesan diterima dalam permintaan.
serverMessage

string

OPSIONAL: Pesan server, terlepas dari clientMessage yang di-echo.

RequestHeader

Objek header yang ditentukan pada semua permintaan yang dikirim ke server.

Representasi JSON 
{
  "requestId": string,
  "requestTimestamp": {
    object (Timestamp)
  },
  "protocolVersion": {
    object (Version)
  },
  "paymentIntegratorAccountId": string
}
Kolom
requestId

string

WAJIB: ID unik permintaan ini.

String ini memiliki panjang maksimal 100 karakter, dan hanya berisi karakter "a-z", "A-Z", "0-9", ":", "-", dan "_".
requestTimestamp

object (Timestamp)

WAJIB: Stempel waktu permintaan ini. Penerima harus memverifikasi bahwa stempel waktu ini adalah ± 60 detik dari 'sekarang', dan menolak permintaan jika tidak. Stempel waktu permintaan ini tidak idempoten setelah percobaan ulang.
protocolVersion

object (Version)

WAJIB: Versi permintaan ini.
paymentIntegratorAccountId

string

WAJIB: Mengidentifikasi akun unik dengan batasan kontraktual.