Method: disburseFundsResultNotification

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

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

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

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

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 1,
      "revision": 0
    },
    "requestId": "KcgwSKrV76eVNDUbsZ4UA3",
    "requestTimestamp": "1481852928293"
  },
  "paymentIntegratorAccountId": "InvisiCashUSA_USD",
  "disburseFundsRequestId": "awNaC510cefae3IJdNEvW2",
  "disburseFundsResult": {
    "disburseFundsResultCode": "SUCCESS"
  }
}

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


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

HTTP-запрос

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

Тело запроса

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

JSON-представление 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "paymentIntegratorAccountId": string,
  "disburseFundsRequestId": string,
  "disburseFundsResult": {
    object (DisburseFundsResult)
  }
}
Поля
requestHeader

object ( RequestHeader )

ОБЯЗАТЕЛЬНО : общий заголовок для всех запросов.

paymentIntegratorAccountId

string

ОБЯЗАТЕЛЬНО : идентификатор счета платежного интегратора, на который была произведена выплата.

disburseFundsRequestId

string

ОБЯЗАТЕЛЬНО : уникальный идентификатор для этой транзакции. Это requestId , сгенерированный Google во время вызова disburseFunds , с которым связан этот запрос.

Это строка максимальной длиной 100 символов, содержащая только символы «az», «AZ», «0-9», «:», «-» и «_».

disburseFundsResult

object ( DisburseFundsResult )

ОБЯЗАТЕЛЬНО : Результат запроса на выплату средств.

Тело ответа

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

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

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

object ( ResponseHeader )

ОБЯЗАТЕЛЬНО : общий заголовок для всех ответов.

result

enum ( DisburseFundsResultNotificationResultCode )

ОБЯЗАТЕЛЬНО : Результат этого вызова.

Результат выплаты средств

Информация об окончательном результате выплаты.

JSON-представление 
{
  "disburseFundsResultCode": enum (DisburseFundsResultCode),
  "rawResult": {
    object (RawResult)
  },

  // Union field FailureDetail can be only one of the following:
  "transactionMaxLimit": string,
  "transactionMinLimit": string
  // End of list of possible types for union field FailureDetail.
}
Поля
disburseFundsResultCode

enum ( DisburseFundsResultCode )

ОБЯЗАТЕЛЬНО : Код результата этой выплаты.

rawResult

object ( RawResult )

НЕОБЯЗАТЕЛЬНО : необработанный результат выплаты. Используется для информирования системы рисков и аналитики Google. В ситуациях отказа от сопоставления кода данные иногда теряются. Интегратор может предоставить Google необработанный код. Например, шлюз кредитных карт (интегратор) может использовать это поле, чтобы сообщить Google точный код отклонения, полученный из сети VISA. В этом случае scope будет «visa», а rawCode — то, что вернула сеть VISA.

Это значение является обязательным , если result не SUCCESS .

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

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

transactionMaxLimit

string ( Int64Value format)

НЕОБЯЗАТЕЛЬНО : если disburseFundsResultCode имеет значение DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT , то это значение максимально допустимой транзакции. Это используется для структурированного обмена сообщениями, ориентированными на пользователя, и анализа темпов снижения.

Эта сумма представляет собой микротот того же currencyCode , что и исходный вызов метода disburseFunds .

transactionMinLimit

string ( Int64Value format)

НЕОБЯЗАТЕЛЬНО : если disburseFundsResultCode имеет DISBURSEMENT_UNDER_TRANSACTION_LIMIT , то это значение минимально допустимой транзакции. Это используется для структурированного, ориентированного на пользователя обмена сообщениями и анализа темпов снижения.

Эта сумма представляет собой микротот того же currencyCode , что и исходный вызов метода disburseFunds .

DisburseFundsResultCode

Коды результатов для вызова выплаты средств.

Перечисления
UNKNOWN_RESULT Никогда не устанавливайте это значение по умолчанию!
SUCCESS Выплата прошла успешно.
DISBURSEMENT_UNDER_TRANSACTION_LIMIT Запрошенная сумма выплаты не соответствует минимальной сумме транзакции, установленной интегратором. Если используется этот код, заполните поле transactionMinLimit минимальной суммой транзакции для целей обмена сообщениями с пользователем.
DISBURSEMENT_EXCEEDS_TRANSACTION_LIMIT Запрошенная сумма выплаты превышает максимальный лимит интегратора на транзакцию. Если этот код используется, заполните поле transactionMaxLimit лимитом транзакции для целей обмена сообщениями с пользователем.
ACCOUNT_CLOSED Учетная запись пользователя у интегратора закрыта. Это возвращаемое значение приведет к закрытию инструмента пользователя в Google. Пользователь будет вынужден добавить новый инструмент.
ACCOUNT_CLOSED_ACCOUNT_TAKEN_OVER Аккаунт пользователя у интегратора закрыт, подозрение на захват аккаунта. Это возвращаемое значение приведет к закрытию инструмента пользователя в Google. Пользователь будет вынужден добавить новый инструмент.
ACCOUNT_CLOSED_FRAUD Аккаунт пользователя у интегратора закрыт из-за мошенничества. Это возвращаемое значение приведет к закрытию инструмента пользователя в Google. Пользователь будет вынужден добавить новый инструмент.
ACCOUNT_ON_HOLD Аккаунт пользователя заблокирован.

RawResult

Необработанный объект результата.

JSON-представление 
{
  "scope": string,
  "rawCode": string
}
Поля
scope

string

НЕОБЯЗАТЕЛЬНО : Область действия rawCode может быть пустой.

rawCode

string

ОБЯЗАТЕЛЬНО : необработанный код интегратора или его подсистем.

DisburseFundsResultNotificationResultCode

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

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