Method: acceptRemittanceStatementWithModifications

告知 Google 我們會在修改本聲明後 (例如重新分類加值稅的費用) 修改這份對帳單中的聲明，讓 Google 付款。

如果這個方法未傳回 HTTP 200，這項查詢的回應可能會空白。在此情況下，如果 ErrorResponse 提供清楚的說明，以便攻擊者瞭解其他整合服務供應商的付款整合商帳戶 ID，則兩者為空白。在這種情況下，如果簽署金鑰不相符或加密金鑰不明，這個方法會傳回主體的 HTTP 404。

以下是要求範例：


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

回應範例如下所示：


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

HTTP 要求

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

要求主體

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

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

  // Union field modification_type can be only one of the following:
  "feeToVatModification": {
    object (FeeToVATModification)
  }
  // End of list of possible types for union field modification_type.
}
欄位
requestHeader

object (RequestHeader)

必要項目：所有要求的通用標頭。
paymentIntegratorAccountId

string

REQUIRED：這是付款整合商帳戶 ID，可用來識別有關這份對帳單的合約限制。
statementId

string

必要項目：要求修改此要求所修改聲明通知的 ID。

聯集欄位 modification_type。

modification_type 只能採用下列其中一種設定：
feeToVatModification

object (FeeToVATModification)

必要項目：要求修改，將部分費用重新歸因於加值稅 (VAT)。

回應主體

acceptRemittanceStatementWithModifications 方法的回應物件。

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

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

object (ResponseHeader)

必要項目：所有回應的通用標頭。
acceptRemittanceStatementWithModificationsResultCode

enum (AcceptRemittanceStatementWithModificationsResultCode)

必要項目：v1.acceptRemittanceStatement 呼叫的結果。

FeeToVATModification

這個物件會提供稅金修改內容，以便套用至匯款對帳單。

JSON 表示法 
{
  "vatToFeeRatioInMicros": string
}
欄位
vatToFeeRatioInMicros

string (Int64Value format)

必填：加值稅與費用金額的比率，以百萬分之一為單位。這是要退還為加值稅的比例，且必須大於或等於 0。四捨五入應為「半平均」或「銀行家」的捨入點，亦即在兩個數字等距的情況下，四捨五入至相等鄰點 (例如 2.5 -> 2、5.5 -> 6)。

計算稅金的範例如下：

  • 付款整合商收取的含稅處理費：$1000 美元
  • 稅率：10%
  • 因此，1000 USD = (處理費) + (10% * 處理費)
  • 手續費 (稅金) = 1000 / 1.1 = 909.090909 美元
  • 付款整合商支付的稅額 = 1000 - 909.090909 = 90.909091 美元
  • vatToFeeRatioInMicros = (90.909091 / 1000) * 1000000 = 90909.091
  • 90909.091 的半七進位法 = 90909

AcceptRemittanceStatementWithModificationsResultCode

列舉
UNKNOWN_RESULT 請不要設定這個預設值！
SUCCESS 成功修改匯款聲明。
INVALID_VAT_MODIFICATION 由於要求無效，我們無法接受加值稅修改。