메인 콘텐츠로 바로가기

웹 SDK 연동 가이드

웹페이지에 휴대폰 번호 인증 버튼을 붙이는 JavaScript SDK입니다. 사용자가 옥토모로 보낸 문자로 번호 소유를 확인합니다.

법적 본인확인(CI/DI)이나 성인 인증은 아닙니다. 고객사 화면과 약관에는 '휴대폰 번호 인증'으로 표기하세요.

시작하기

  1. API Key 확인 마이페이지 › 대시보드의 애플리케이션에서 확인합니다. API Key는 서버에만 둡니다.
  2. 프론트엔드 연동 SDK를 불러와 인증 버튼을 추가합니다. 가이드 →
  3. 백엔드 연동 옥토모 API 2개(발급, 최종 확인)를 호출합니다. 가이드 →

연동 전에 API 테스트에서 실제로 인증해 보세요 →

동작 방식

실선은 요청, 점선은 응답입니다. API Key가 필요한 호출은 모두 고객사 서버가 합니다.

웹 SDK 인증 시퀀스 다이어그램1. 사용자에서 웹 SDK (브라우저)로: 버튼을 누르고 번호 입력 2. 웹 SDK (브라우저)에서 고객사 서버로: onPhoneSubmit({ phoneNumber }) 3. 고객사 서버에서 옥토모로: POST /public/sdk/verifications 4. 옥토모에서 고객사 서버로: 토큰, 문자 본문, 수신번호 5. 고객사 서버에서 웹 SDK (브라우저)로: 발급 응답 그대로 전달 6. 웹 SDK (브라우저)에서 사용자로: 문자 앱 열기 또는 QR 표시 7. 사용자에서 옥토모로: 휴대폰에서 문자 전송 8. 사용자에서 웹 SDK (브라우저)로: '문자 전송 확인' 누름 9. 웹 SDK (브라우저)에서 옥토모로: GET /public/sdk/verifications/status 10. 옥토모에서 웹 SDK (브라우저)로: verified (아직이면 pending, 다시 누름) 11. 웹 SDK (브라우저)에서 고객사 서버로: onComplete({ verificationToken }) 12. 고객사 서버에서 옥토모로: POST /public/sdk/verifications/consume 13. 옥토모에서 고객사 서버로: phoneNumber, verificationId 14. 고객사 서버에서 웹 SDK (브라우저)로: 번호 대조 후 가입 등 업무 처리 결과사용자웹 SDK (브라우저)고객사 서버옥토모인증 발급1. 버튼을 누르고 번호 입력2. onPhoneSubmit({ phoneNumber })3. POST /public/sdk/verifications4. 토큰, 문자 본문, 수신번호5. 발급 응답 그대로 전달문자 전송6. 문자 앱 열기 또는 QR 표시7. 휴대폰에서 문자 전송수신 확인8. '문자 전송 확인' 누름9. GET /public/sdk/verifications/status10. verified (아직이면 pending, 다시 누름)최종 확인11. onComplete({ verificationToken })12. POST /public/sdk/verifications/consume13. phoneNumber, verificationId14. 번호 대조 후 가입 등 업무 처리 결과
OCTOMO

주식회사 옥토버스

대표 김종민

사업자 등록번호 803-88-02517

서울특별시 영등포구 국회대로36길 6-1, 2층 디599호

고객센터 1666-3538

이메일 hercules@octoverse.kr