Method: verifyOtp

驗證動態密碼由帳戶的整合者傳送。

如果端點在處理要求時發生錯誤,此端點的回應內文就應該是 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

必要:在此呼叫之前的 sendOtp 要求中的 requestId

otp

string

必要:這是使用者提供的動態密碼,此呼叫正在驗證

回應主體

validationOtp 方法的回應物件。

如果成功,回應主體即會包含具有以下結構的資料:

JSON 表示法
{
  "responseHeader": {
    object (ResponseHeader)
  },
  "paymentIntegratorVerifyOtpId": string,
  "result": enum (VerifyOtpResultCode)
}
欄位
responseHeader

object (ResponseHeader)

必要:所有回應的通用標頭。

paymentIntegratorVerifyOtpId

string

OPTIONAL:整合商知道此驗證動態密碼要求。此為系統的整合商。

result

enum (VerifyOtpResultCode)

REQUIRED:這項要求的結果

驗證結果程式碼

驗證動態密碼要求的結果代碼

列舉
UNKNOWN_RESULT 不要設定這個預設值!
SUCCESS 動態密碼與整合商傳送的內容相符
OTP_NOT_MATCHED 動態密碼與整合器傳送的內容不符。
OTP_ALREADY_USED 動態密碼已使用過。