Method: verifyOtp

Проверяет, что значение OTP было отправлено интегратором для учетной записи.

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

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


{
  "requestHeader": {
    "protocolVersion": {
      "major": 1,
      "minor": 0,
      "revision": 0
    },
    "requestId": "0123434-otp-abc",
    "requestTimestamp": "1502545413098"
  },
  "sendOtpRequestId": "0123434-otp-abc",
  "otp": "7754321"
}

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


{
  "responseHeader": {
    "responseTimestamp": "1502545413132"
  },
  "paymentIntegratorVerifyOtpId": "5539163",
  "result": "SUCCESS"
}

HTTP-запрос

POST https://www.integratorhost.example.com/v1/verifyOtp

Тело запроса

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

Представление JSON
{
  "requestHeader": {
    object (RequestHeader)
  },
  "sendOtpRequestId": string,
  "otp": string
}
Поля
requestHeader

object ( RequestHeader )

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

sendOtpRequestId

string

ТРЕБУЕТСЯ : requestId из запроса sendOtp , который предшествовал этому вызову.

otp

string

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

Тело ответа

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

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

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

object ( ResponseHeader )

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

paymentIntegratorVerifyOtpId

string

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

result

enum ( VerifyOtpResultCode )

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

VerifyOtpResultCode

Коды результатов проверки OTP-запроса

перечисления
UNKNOWN_RESULT Никогда не устанавливайте это значение по умолчанию!
SUCCESS OTP соответствует тому, что отправил интегратор
OTP_NOT_MATCHED OTP не соответствует тому, что отправил интегратор.
OTP_ALREADY_USED OTP уже был использован.