Сообщите Google о результате возврата после вызова метода refund
.
Возвраты должны обрабатываться синхронно во время вызова метода refund
, но этот метод предоставляет Google быстрый резервный сигнал на случай сбоя синхронного вызова после выполнения действия, но до того, как он сможет вернуть результат. Это позволяет избежать задержки, связанной с тем, что Google планирует повторную попытку в будущем.
Значение refundResult
является идемпотентным для этого refundRequestId
, поэтому его значение не может быть изменено последующим вызовом этого метода.
Если конечная точка обнаружит ошибку при обработке запроса, ответ от этой конечной точки будет иметь тип
.ErrorResponse
Ответы на этот запрос могут быть пустыми, если этот метод не возвращает HTTP 200. Тело ответа пусто в ситуациях, когда
с четким описанием может помочь злоумышленнику понять идентификатор учетной записи платежного интегратора других интеграторов. В этих ситуациях, когда либо ключ подписи не совпадает, либо идентификатор интегратора платежей не найден, либо ключ шифрования неизвестен, этот метод вернет HTTP 404 с пустым телом. Если подпись запроса удалось проверить, в теле ответа будет возвращена дополнительная информация об ошибке.ErrorResponse
Пример запроса выглядит так:
{
"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 | ТРЕБУЕТСЯ : идентификатор аккаунта платежного интегратора, на который был осуществлен возврат средств. |
refundRequestId | ТРЕБУЕТСЯ : Уникальный идентификатор для этого возврата, установленный полем |
refundResult | НЕОБХОДИМО : результат этого возврата. |
paymentIntegratorRefundId | ТРЕБУЕТСЯ : Этот идентификатор специфичен для интегратора и создается интегратором. Это идентификатор, по которому интегратор знает этот возврат. Для удобства этот идентификатор включен в реквизиты денежного перевода. |
Тело ответа
Объект ответа для метода refundResultNotification
.
В случае успеха тело ответа содержит данные со следующей структурой:
Представление JSON |
---|
{ "responseHeader": { object ( |
Поля | |
---|---|
responseHeader | ТРЕБУЕТСЯ : Общий заголовок для всех ответов. |
result | НЕОБХОДИМО : результат этого вызова. |
код результата возврата
Уникальные коды результатов возвращают деньги.
перечисления | |
---|---|
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 | Уведомление о результате возврата прошло успешно. |