告知 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 |
必需:这是付款集成商帐号标识符,用于标识有关此对账单的合同限制。 |
statementId |
必需:此请求修改的语句通知的请求 ID。 |
联合字段
|
|
feeToVatModification |
必需:申请修改部分费用以缴纳增值税 (VAT)。 |
响应正文
acceptRemittanceStatementWithModifications
方法的响应对象。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "responseHeader": { object ( |
字段 | |
---|---|
responseHeader |
必需:所有响应的通用标头。 |
acceptRemittanceStatementWithModificationsResultCode |
必需:v1.acceptRemittanceStatement 调用的结果。 |
FeeToVATModification
此对象提供要应用于汇款对账单的税费修改。
JSON 表示法 |
---|
{ "vatToFeeRatioInMicros": string } |
字段 | |
---|---|
vatToFeeRatioInMicros |
必需:增值税与费用金额的比率(以微单位表示)。这是重新归因于增值税的费用百分比,必须大于或等于零。舍入应为“半偶数”或“银行家”舍入,即在两个数字等距时舍入到偶数(例如 2.5 -> 2、5.5 -> 6)。 计算税费的示例如下:
|
AcceptRemittanceStatementWithModificationsResultCode
枚举 | |
---|---|
UNKNOWN_RESULT |
切勿设置此默认值! |
SUCCESS |
已成功接受并修改了汇款对账单。 |
INVALID_VAT_MODIFICATION |
由于申请无效,系统未接受增值税修改。 |