토스인증 시작하기

토스인증은 토스 앱을 통해 사용자의 신원을 안전하게 확인하는 인증 서비스입니다. 별도의 공인인증서 없이 토스 앱 하나로 본인확인, 간편인증, 전자서명, 마이데이터 통합인증을 처리할 수 있습니다.

연동을 시작하기 전에 cert.support@toss.im으로 Client ID·Secret 발급을 먼저 요청하세요.

제공 서비스

서비스	이런 상황에 쓰세요	주요 사용 사례
본인확인	고객의 CI/DI가 필요한 경우, 휴대폰 본인확인 대신 사용	회원가입, 계정 조회
간편인증	고객의 CI를 이미 확보한 경우, 빠르게 본인 여부를 확인하고 싶을 때 사용	로그인, 가입 조회
전자서명	고객의 동의·서명이 법적으로 필요한 경우	계좌개설, 대출 약관 동의, 보험계약
마이데이터 통합인증	마이데이터 사업자·정보제공자 기관인 경우	마이데이터 서비스

CI/DI란?

CI (연계정보): 한 사람을 여러 서비스에서 동일하게 식별할 수 있는 고유 코드입니다. 주민등록번호를 대체해 본인 여부를 확인할 때 사용합니다.
DI (중복가입확인정보): 동일한 사람이 같은 서비스에 중복 가입했는지 확인하는 코드입니다. 서비스별로 다른 값이 발급됩니다.

전체 연동 흐름

모든 서비스는 아래 4단계로 동작합니다.

1. Access Token 발급  →  2. 인증 요청 (txId 발급)  →  3. 상태 조회  →  4. 결과 조회

단계	설명
1. Access Token 발급	서버 인증용 토큰을 발급받습니다. 만료 전까지 재사용하세요.
2. 인증 요청	각 서비스 요청 API를 호출해 거래 ID(`txId`)를 발급받습니다.
3. 상태 조회	`txId`로 고객의 인증 진행 상태를 확인합니다.
4. 결과 조회	인증 완료 후 결과조회 API로 최종 결과와 개인정보를 가져옵니다. 완료 판별은 반드시 이 단계에서 하세요.

Access Token 발급

토스인증 API는 Bearer 토큰 방식으로 인증합니다. 모든 API 요청 시 발급받은 Access Token을 헤더에 포함해야 합니다. 아래 API로 Access Token을 발급받으세요.

POST https://oauth2.cert.toss.im/token

요청 헤더

이름	값
Content-Type	`application/x-www-form-urlencoded`

요청 파라미터

파라미터	필수	설명
grant_type	Y	`client_credentials`
scope	Y	`ca`
client_id	Y	발급받은 Client ID
client_secret	Y	발급받은 Client Secret

bash

curl --request POST 'https://oauth2.cert.toss.im/token' \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'scope=ca' \
  --data-urlencode "client_id={YOUR_CLIENT_ID}" \
  --data-urlencode "client_secret={YOUR_CLIENT_SECRET}"

응답

json

{
  "access_token": "eyJraWQiOiJjZXJ0...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "ca"
}

TIP

유효한 토큰이 있을 때 반복 발급하지 마세요. 토큰이 만료되면 새로 발급받으세요.

다음 단계

공통 정보 — 도메인, 방화벽 설정, 암복호화, TLS 등 기술 스펙을 확인하세요.

토스인증 시작하기 ​

제공 서비스 ​

전체 연동 흐름 ​

Access Token 발급 ​

다음 단계 ​

토스인증 시작하기

제공 서비스

전체 연동 흐름

Access Token 발급

다음 단계