Method: acceptRemittanceStatementWithModifications

告知 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",
  "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

必要項目：這是付款整合商帳戶 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)

必要項目：加值稅與費用金額的比率 (以微量為單位)。這是指重新歸因於加值稅的費用的百分比，且必須大於或等於零。四捨五入應為「半均值」或「banker's」四捨五入，如果兩個數字為等距 (例如 2.5 -> 2、5.5 -> 6)，則四捨五入為平均鄰點。

稅金計算範例如下：

  • 付款整合商收取的含稅手續費：1000 美元
  • 稅率：10%
  • 因此，1000 美元 = (處理費用) + (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 由於要求無效，因此未接受更改加值稅。