Method: verifyOtp

Sprawdza, czy hasło jednorazowe jest wysyłane przez integratora konta.

Jeśli podczas przetwarzania żądania punkt końcowy napotka błąd, treść odpowiedzi tego punktu końcowego powinna być typu ErrorResponse.

Przykładowe żądanie wygląda tak:


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

Przykładowa odpowiedź:


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

Żądanie HTTP

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

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "requestHeader": {
    object (RequestHeader)
  },
  "sendOtpRequestId": string,
  "otp": string
}
Pola
requestHeader

object (RequestHeader)

REQUIRED: wspólny nagłówek dla wszystkich żądań,
sendOtpRequestId

string

WYMAGANE: requestId z żądania sendOtp poprzedzającego to połączenie.
otp

string

WYMAGANE: to hasło jednorazowe od użytkownika, które jest weryfikowane przez to połączenie.

Treść odpowiedzi

Obiekt odpowiedzi na metodę weryfikacjiOOp.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "paymentIntegratorVerifyOtpId": string,
  "result": enum (VerifyOtpResultCode)
}
Pola
responseHeader

object (ResponseHeader)

WYMAGANE: wspólny nagłówek wszystkich odpowiedzi.
paymentIntegratorVerifyOtpId

string

OPCJONALNIE: integrator zna to zweryfikowane żądanie hasła jednorazowego. Został wygenerowany przez integratora.
result

enum (VerifyOtpResultCode)

REQUIRED: wynik tego żądania

WeryfikacjaOOppCode

Kody wyników weryfikacji hasła jednorazowego

Wartości w polu enum
UNKNOWN_RESULT Nie ustawiaj nigdy tej wartości domyślnej!
SUCCESS Hasło jednorazowe zostało dopasowane do tego, jaki wysłał integrator
OTP_NOT_MATCHED Hasło jednorazowe nie pasuje do wysłanego przez integratora.
OTP_ALREADY_USED Hasło jednorazowe zostało już użyte.