Method: acceptRemittanceStatementWithModifications

告知 Google，在修改此对账单（例如增值税重新分类的费用）后，将向 Google 支付此请求中指明的对账单费用。

如果端点在处理请求时遇到错误，来自此端点的响应将是 ErrorResponse 类型。

如果此方法没有返回 HTTP 200，则对此查询的响应可能为空。如果包含明确说明的 ErrorResponse 可用于帮助攻击者了解其他集成商的付款集成商账号标识符，则响应正文为空。在这些情况下，如果签名密钥不匹配、未找到付款集成商标识符或加密密钥未知，此方法将返回正文为空的 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

必需：这是付款集成商账号标识符，用于标识此对账单所遵循的合同限制。
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)

必需：增值税与费用金额的比率（以微单位表示）。这是要重新计入增值税的费用所占的百分比，必须大于或等于零。舍入应为“半均匀”或“银行家的”舍入，表示在两个数字的距离相等（例如 2.5 -> 2，5.5 -> 6）的情况下，四舍五入为偶数相邻项。

计算税费的示例如下：

  • 付款集成商收取的含税手续费：1000 美元
  • 税率：10%
  • 因此，1000 美元 = (手续费) + (10% * 手续费)
  • 手续费（美国税）= 1000 / 1.1 = 909.090909 USD
  • 付款集成商缴纳的税款 = 1000 - 909.090909 = 90.909091 USD
  • vatToFeeRatioInMicros = (90.909091 / 1000) * 1000000 = 90909.091
  • 对 90909.091 进行半偶舍入 = 90909

AcceptRemittanceStatementWithModificationsResultCode

枚举
UNKNOWN_RESULT 切勿设置此默认值！
SUCCESS 已成功接受已修改的汇款对账单。
INVALID_VAT_MODIFICATION 由于请求无效，因此增值税修改未被接受。