마이데이터 통합인증

마이데이터 사업자와 정보제공자 기관을 위한 통합인증 서비스입니다. 금융보안원에서 제공하는 표준 가이드 규격을 기반으로 합니다.

Base URL https://mydata.cert.toss.im

---

사전 준비

연동 전 아래 항목을 먼저 확인하세요.

• 테스트 환경 클라이언트 자격증명 정보
• 방화벽 설정 (마이데이터 통합인증은 별도 IP 허용 필요)

---

연동 흐름

마이데이터 사업자가 정보제공자 기관에 고객 인증을 요청하면, 정보제공자가 토스인증 서버로 서명 검증을 요청하는 흐름입니다.

---

Access Token 발급

마이데이터 통합인증도 동일하게 Access Token이 필요합니다. 시작하기를 참고하세요.

---

인증 검증

POST https://mydata.cert.toss.im/v1/ca/sign_verification

마이데이터 통합인증 서명을 검증하고 사용자 CI를 반환합니다.

INFO

테스트 환경에서는 실제 고객 CI 대신 가상 인물의 고유한 CI를 제공합니다. 운영 환경에서는 실제 고객 CI가 사용됩니다.

요청

요청 헤더

이름	필수	설명
Authorization	Y	Bearer {access_token}
x-api-tran-id	Y	거래 추적용 트랜잭션 ID
Content-Type	Y	application/json

요청 파라미터

파라미터	필수	설명
cert_tx_id	Y	인증서 거래 ID
tx_id	Y	거래 ID
signed_consent_len	Y	서명된 동의서 길이
signed_consent	Y	서명된 동의서 데이터
consent_type	Y	동의 유형
consent_len	Y	동의 길이
consent	Y	동의 해시값

요청 예시

{
  "cert_tx_id": "인증서 거래ID",
  "tx_id": "거래ID",
  "signed_consent_len": 1234,
  "signed_consent": "Base64 인코딩된 서명 데이터",
  "consent_type": "0",
  "consent_len": 256,
  "consent": "동의 해시값"
}

성공 응답

{
  "tx_id": "거래ID",
  "rsp_code": "00000",
  "rsp_msg": "성공",
  "result": "true",
  "user_ci": "사용자 CI"
}

실패 응답

{
  "tx_id": "거래ID",
  "rsp_code": "40101",
  "rsp_msg": "유효하지 않은 접근토큰입니다",
  "result": "false",
  "user_ci": ""
}

---

에러 코드

마이데이터 통합인증 전용 에러코드는 에러 코드 > 마이데이터 통합인증을 참고하세요.