驗證動態密碼由帳戶的整合者傳送。
如果端點在處理要求時發生錯誤,此端點的回應內文就應該是
類型。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 |
必要:在此呼叫之前的 |
otp |
必要:這是使用者提供的動態密碼,此呼叫正在驗證 |
回應主體
validationOtp 方法的回應物件。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "responseHeader": { object ( |
欄位 | |
---|---|
responseHeader |
必要:所有回應的通用標頭。 |
paymentIntegratorVerifyOtpId |
OPTIONAL:整合商知道此驗證動態密碼要求。此為系統的整合商。 |
result |
REQUIRED:這項要求的結果 |
驗證結果程式碼
驗證動態密碼要求的結果代碼
列舉 | |
---|---|
UNKNOWN_RESULT |
不要設定這個預設值! |
SUCCESS |
動態密碼與整合商傳送的內容相符 |
OTP_NOT_MATCHED |
動態密碼與整合器傳送的內容不符。 |
OTP_ALREADY_USED |
動態密碼已使用過。 |