Method: refundResultNotification

Сообщите Google о результате возврата после вызова метода refund .

Возвраты должны обрабатываться синхронно во время вызова метода refund , но этот метод предоставляет Google быстрый резервный сигнал на случай сбоя синхронного вызова после выполнения действия, но до того, как он сможет вернуть результат. Это позволяет избежать задержки, связанной с тем, что Google планирует повторную попытку в будущем.

Значение refundResult является идемпотентным для этого refundRequestId , поэтому его значение не может быть изменено последующим вызовом этого метода.

Если конечная точка обнаружит ошибку при обработке запроса, ответ от этой конечной точки будет иметь тип ErrorResponse .

Ответы на этот запрос могут быть пустыми, если этот метод не возвращает HTTP 200. Тело ответа пусто в ситуациях, когда ErrorResponse с четким описанием может помочь злоумышленнику понять идентификатор учетной записи платежного интегратора других интеграторов. В этих ситуациях, когда либо ключ подписи не совпадает, либо идентификатор интегратора платежей не найден, либо ключ шифрования неизвестен, этот метод вернет HTTP 404 с пустым телом. Если подпись запроса удалось проверить, в теле ответа будет возвращена дополнительная информация об ошибке.

Пример запроса выглядит так:


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "HsKv5pvtQKTtz7rdcw1YqE",
    "requestTimestamp": "1481855928301"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "refundRequestId": "hH1T32PI86CpKwjuf6oD2r",
  "paymentIntegratorRefundId": "invisi/Id::xx__1243",
  "refundResult": "SUCCESS"
}

Пример ответа выглядит так:


{
  "responseHeader": {
    "responseTimestamp": "1481855928376"
  },
  "result": "SUCCESS"
}

HTTP-запрос

POST https://vgw.googleapis.com/secure-serving/gsp/v1/refundResultNotification/ :PIAID

Тело запроса

Тело запроса содержит данные со следующей структурой:

Представление JSON
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "refundRequestId": string,
  "refundResult": enum (RefundResultCode),
  "paymentIntegratorRefundId": string
}
Поля
requestHeader

object ( RequestHeader )

ТРЕБУЕТСЯ : Общий заголовок для всех запросов.

paymentIntegratorAccountId

string

ТРЕБУЕТСЯ : идентификатор аккаунта платежного интегратора, на который был осуществлен возврат средств.

refundRequestId

string

ТРЕБУЕТСЯ : Уникальный идентификатор для этого возврата, установленный полем requestId при вызове метода refund .

refundResult

enum ( RefundResultCode )

НЕОБХОДИМО : результат этого возврата.

paymentIntegratorRefundId

string

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

Для удобства этот идентификатор включен в реквизиты денежного перевода.

Тело ответа

Объект ответа для метода refundResultNotification .

В случае успеха тело ответа содержит данные со следующей структурой:

Представление JSON
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "result": enum (RefundResultNotificationResultCode)
}
Поля
responseHeader

object ( ResponseHeader )

ТРЕБУЕТСЯ : Общий заголовок для всех ответов.

result

enum ( RefundResultNotificationResultCode )

НЕОБХОДИМО : результат этого вызова.

код результата возврата

Уникальные коды результатов возвращают деньги.

перечисления
UNKNOWN_RESULT Никогда не устанавливайте это значение по умолчанию!
SUCCESS Успешный возврат.
NO_MONEY_LEFT_ON_TRANSACTION Возврат не удался, денег на транзакцию не осталось. Обычно это ошибка между интегратором и Google. Google не должен требовать возмещения суммы, превышающей первоначальный захват.
ACCOUNT_CLOSED

Аккаунт интегратора закрыт.

Возврат этого значения приведет к закрытию инструмента пользователя в Google. Пользователь будет вынужден добавить новый инструмент, снова пройдя через процесс ассоциации.

ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER

Учетная запись пользователя в интеграторе была закрыта, подозреваемая учетная запись вступила во владение.

Возврат этого значения приведет к закрытию инструмента пользователя в Google. Пользователь будет вынужден добавить новый инструмент, снова пройдя через процесс ассоциации.

ACCOUNT_CLOSED_FRAUD

Учетная запись пользователя, принадлежащая интегратору, была закрыта из-за мошенничества.

Возврат этого значения приведет к закрытию инструмента пользователя в Google. Пользователь будет вынужден добавить новый инструмент, снова пройдя через процесс ассоциации.

ACCOUNT_ON_HOLD Учетная запись пользователя в настоящее время приостановлена ​​и не может принять возмещение, но позже учетная запись пользователя сможет принять возмещение. Google может запросить еще один возврат средств в будущем, но сделает это с новым requestId , поэтому этот запрос следует считать завершенным.
REFUND_EXCEEDS_MAXIMUM_BALANCE Возврат не может быть обработан в настоящее время, так как это приведет к тому, что баланс пользователя превысит максимально допустимую сумму. Google может запросить еще один возврат средств в будущем, но сделает это с новым requestId , поэтому этот запрос следует считать завершенным.
REFUND_WINDOW_EXCEEDED Возврат не может быть обработан, так как срок запроса истек.

RefundResultNotificationResultCode

Коды результатов для метода refundResultNotification .

перечисления
UNKNOWN_RESULT Никогда не устанавливайте это значение по умолчанию!
SUCCESS Уведомление о результате возврата прошло успешно.