告知 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 |
REQUIRED:這是付款整合商帳戶 ID,可用來識別有關這份對帳單的合約限制。 |
statementId |
必要項目:要求修改此要求所修改聲明通知的 ID。 |
聯集欄位
|
|
feeToVatModification |
必要項目:要求修改,將部分費用重新歸因於加值稅 (VAT)。 |
回應主體
acceptRemittanceStatementWithModifications
方法的回應物件。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "responseHeader": { object ( |
欄位 | |
---|---|
responseHeader |
必要項目:所有回應的通用標頭。 |
acceptRemittanceStatementWithModificationsResultCode |
必要項目:v1.acceptRemittanceStatement 呼叫的結果。 |
FeeToVATModification
這個物件會提供稅金修改內容,以便套用至匯款對帳單。
JSON 表示法 |
---|
{ "vatToFeeRatioInMicros": string } |
欄位 | |
---|---|
vatToFeeRatioInMicros |
必填:加值稅與費用金額的比率,以百萬分之一為單位。這是要退還為加值稅的比例,且必須大於或等於 0。四捨五入應為「半平均」或「銀行家」的捨入點,亦即在兩個數字等距的情況下,四捨五入至相等鄰點 (例如 2.5 -> 2、5.5 -> 6)。 計算稅金的範例如下:
|
AcceptRemittanceStatementWithModificationsResultCode
列舉 | |
---|---|
UNKNOWN_RESULT |
請不要設定這個預設值! |
SUCCESS |
成功修改匯款聲明。 |
INVALID_VAT_MODIFICATION |
由於要求無效,我們無法接受加值稅修改。 |