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

必需:这是用户提供的动态密码,此调用将验证此密码

响应正文

verifyOtp 方法的响应对象。

如果成功,响应正文将包含结构如下的数据:

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

object (ResponseHeader)

必需:所有响应的通用标头。

paymentIntegratorVerifyOtpId

string

可选:集成商知道此验证动态密码请求的标识符。由集成商生成。

result

enum (VerifyOtpResultCode)

必需:此请求的结果

VerifyOtpResultCode

动态密码验证请求的结果代码

枚举
UNKNOWN_RESULT 切勿设置此默认值!
SUCCESS 动态密码与集成商发送的内容一致
OTP_NOT_MATCHED 动态密码与集成商发送的内容不符。
OTP_ALREADY_USED 动态密码已被使用。