Method: acceptRemittanceStatement

告知 Google 此要求中指明的對帳單將支付費用。

如果端點在處理要求時發生錯誤,此端點的回應就會是 ErrorResponse 類型。

如果這個方法未傳回 HTTP 200,則這個查詢的回應可能為空白。如果可以使用 ErrorResponse 的詳細說明,則可讓攻擊者瞭解其他整合商的付款整合商帳戶 ID。在這些情況下,如果簽署金鑰不相符、找不到付款整合商 ID 或加密金鑰不明,這個方法就會傳回空的 HTTP 404。如果可以驗證要求簽章,系統會在回應內文中傳回錯誤的詳細資訊。

要求範例如下:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-abc",
    "requestTimestamp": "1502545413098"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "statementId": "0123434-statement-abc"
}

回應範例如下:


{
  "responseHeader": {
    "responseTimestamp": "1519996752221"
  },
  "acceptRemittanceStatementResultCode": "SUCCESS"
}

HTTP 要求

POST https://vgw.googleapis.com/secure-serving/gsp/v1/acceptRemittanceStatement/:PIAID

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "statementId": string
}
欄位
requestHeader

object (RequestHeader)

必要:所有要求的通用標頭。

paymentIntegratorAccountId

string

必要:這是付款整合商的帳戶 ID,用來識別關於這份對帳單的合約限制。

statementId

string

REQUIRED:陳述式通知的要求 ID。

回應主體

acceptRemittanceStatement 方法的回應物件。

如果成功,回應主體即會包含具有以下結構的資料:

JSON 表示法
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "acceptRemittanceStatementResultCode": enum (AcceptRemittanceStatementResultCode)
}
欄位
responseHeader

object (ResponseHeader)

必要:所有回應的通用標頭。

acceptRemittanceStatementResultCode

enum (AcceptRemittanceStatementResultCode)

REQUIRED:v1.acceptRemittanceStatement 呼叫的結果。

AcceptRemittanceStatementResultCode 欄位

列舉
UNKNOWN_RESULT 不要設定這個預設值!
SUCCESS 已成功接受匯款聲明