Method: acceptRemittanceStatementWithModifications

告知 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 调用的结果。

其他费用修改

此对象提供要应用于汇款对帐单的税费修改。

JSON 表示法 
{
  "vatToFeeRatioInMicros": string
}
字段
vatToFeeRatioInMicros

string (Int64Value format)

必需：增值税与费用的比率（以微单位表示）。这是重新归因于增值税的费用百分比，必须大于或等于零。舍入应为“半偶”或“银行家”舍入，这意味着在两个数字等距的情况下舍入（例如，2.5 -> 2，5.5 -> 6）。

计算税款的示例如下：

  • 付款集成商收取的含税处理费：1000 美元
  • 税率：10%
  • 因此，1000 USD =（手续费）+（10% * 手续费）
  • 手续费 (sans tax) = 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 由于申请无效，增值税未通过修改。