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

ТРЕБУЕТСЯ : Идентификатор запроса уведомления об операторе, которое модифицирует этот запрос.

Поле объединения modification_type .

modification_type может быть только одной из следующих:

feeToVatModification

object ( FeeToVATModification )

ТРЕБУЕТСЯ : запрошено изменение для перераспределения части сборов на налог на добавленную стоимость (НДС).

Тело ответа

Объект ответа для метода 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 долларов США.
  • Налог, уплаченный платежным интегратором = 1000 - 909,090909 = 90,909091 долларов США
  • vatToFeeRatioInMicros = (90,909091 / 1000) * 1000000 = 90909,091
  • Получетное округление 90909,091 = 90909

AcceptRemittanceStatementWithModificationsResultCode

перечисления
UNKNOWN_RESULT Никогда не устанавливайте это значение по умолчанию!
SUCCESS Выписка о денежном переводе успешно принята с изменениями.
INVALID_VAT_MODIFICATION Изменение НДС не было принято из-за недействительного запроса.