Method: acceptRemittanceStatementWithModifications

このリクエストに記載されている明細書は、VAT 再分類料金などの明細書への変更後に支払われます。

エンドポイントでリクエストの処理中にエラーが発生した場合、このエンドポイントからのレスポンスは 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

必須: このステートメントに関連する契約上の制約を識別する決済インテグレーターのアカウント 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 呼び出しの結果。

料金と VAT の変更

このオブジェクトは、送金明細書に適用される税額の変更を提供します。

JSON 表現 
{
  "vatToFeeRatioInMicros": string
}
フィールド
vatToFeeRatioInMicros

string (Int64Value format)

必須: 手数料額に対する VAT の比率（マイクロ単位）。VAT に配分し直す手数料の割合です。0 以上である必要があります。丸めは「半角」または「偶数」です。両方の数値が等距離の場合は（たとえば 2.5 -> 2、5.5 -> 6）、偶数に丸めます。

税金の計算例を以下に示します。

  • 決済インテグレーターが徴収する税込みの処理手数料: 1,000 USD
  • 税率: 10%
  • つまり、1, 000 USD =（処理手数料）+（10% × 処理手数料）
  • 手数料（Sans Tax）= 1,000 ÷ 1.1 = 909.090909 USD
  • 決済インテグレーターが支払う税金 = 1,000 - 909.090909 = 90.909091 USD
  • vatToFeeRatioInMicros = (90.909091 / 1000) × 1000000 = 90909.091
  • 90909.091 = 90909 で半円を丸める

AcceptRemittanceStatementWithModificationsResultCode

列挙型
UNKNOWN_RESULT このデフォルト値を設定しないでください。
SUCCESS 修正を行い、送金明細書を承認しました。
INVALID_VAT_MODIFICATION 無効なリクエストのため、VAT の変更が承認されませんでした。