標準化的簡訊驗證碼:服務方請電信發送驗證碼,再把使用者輸入的驗證碼交回電信核對。
GSMA 應用情境
A發送驗證碼
電信回覆已發送
電信產生驗證碼,用簡訊發到使用者手機。
B輸入正確
電信回覆驗證成功
使用者輸入正確,電信回覆驗證成功。
C輸入錯誤
電信回覆驗證碼錯誤
輸入錯誤,電信回覆驗證碼錯誤;過期或嘗試太多次也會告知。
A驗證碼由電信產生與保管,服務方不必自建簡訊閘道。
B 與 C核對結果由電信判斷,服務方依回覆代碼處理。
簡訊一次性密碼:運作原理
- 發送服務方送出門號與簡訊範本,範本裡用 {{code}} 標出驗證碼的位置。
- 輸入使用者收到簡訊,在 App 輸入驗證碼。
- 核對服務方送出 authenticationId 與驗證碼,電信核對後回覆結果。
簡訊一次性密碼:API 規格
規格名稱
One Time Password SMS(CAMARA 開源規格)
呼叫方式
POST /send-code 發送;POST /validate-code 核對發送輸入
phoneNumber、message(須包含 {{code}})核對輸入
authenticationId、code典型用途
App 註冊、登入時的簡訊驗證碼
| 回覆與錯誤代碼 | 意思 | 範例 |
|---|---|---|
| authenticationId | 這次驗證的編號 | ea0840f3-… |
| 204 | 驗證成功 | — |
| INVALID_OTP | 驗證碼不正確 | ONE_TIME_PASSWORD_SMS.INVALID_OTP |
| VERIFICATION_EXPIRED | 驗證編號已過期 | ONE_TIME_PASSWORD_SMS.VERIFICATION_EXPIRED |
| VERIFICATION_FAILED | 嘗試次數過多 | ONE_TIME_PASSWORD_SMS.VERIFICATION_FAILED |
| MAX_OTP_CODES_EXCEEDED | 要求發送的次數過多 | ONE_TIME_PASSWORD_SMS.MAX_OTP_CODES_EXCEEDED |
三個情境的回覆內容(節錄)
A發送驗證碼
authenticationId
ea0840f3-3663-4149-bd10-c7c6b8912105這次驗證的編號,核對時要帶上B輸入正確
HTTP 狀態
204驗證成功(沒有回覆內容)C輸入錯誤
code
ONE_TIME_PASSWORD_SMS.INVALID_OTP驗證碼不正確規格來源:CAMARA OTPValidation r3.2(One Time Password SMS v1.1.1)
簡訊一次性密碼:GSMA 應用情境
簡訊驗證碼重設密碼Online password reset using SMS OTP
金融零售媒體
要解決的問題保護重設密碼的流程。
簡訊一次性密碼的角色發送短效驗證碼到帳戶綁定的門號再核對,確認提出要求的人持有對應的手機。
GSMA 原文 ↗GSMA 實際案例(2)
資料來源:GSMA Open Gateway Use Case Library 與 API Descriptions(2026-10-14 讀取),中文為摘要翻譯。