인증서 유효성 확인

본인확인·전자서명 결과에 포함된 토스 인증서의 유효 상태를 직접 검증할 수 있습니다. 연동 시 필수는 아니지만, 인증서 만료·폐기 여부를 확인해야 하는 경우에 활용하세요.

---

인증서 추출 (openssl)

결과조회 API에서 받은 서명값을 openssl로 PEM 형식 인증서로 변환합니다.

• 본인확인·간편인증: $SIGNED_DOC 자리에 응답의 signature 필드 값 사용
• 전자서명 (단건·다건): $SIGNED_DOC 자리에 응답의 signedDoc 필드 값 사용

# 1. Base64 디코딩 → 2. PKCS#7에서 인증서 추출 → 3. PEM 형식으로 출력
echo $SIGNED_DOC | openssl base64 -d -A | openssl pkcs7 -print_certs -inform DER | openssl x509

출력된 PEM 형식 데이터를 아래 API에 전달합니다.

---

인증서 유효성 확인 API

POST https://cert.toss.im/api/v1/certificate/validate

요청

요청 헤더

이름	필수	설명
Authorization	Y	Bearer {access_token}
Content-Type	Y	application/json

요청 파라미터

파라미터	필수	설명
certificate	Y	PEM 형식의 인증서 데이터

성공 응답

{
  "resultType": "SUCCESS",
  "success": {
    "valid": true,
    "enabled": true
  }
}

응답 파라미터

필드	타입	설명
valid	Boolean	인증서 유효 여부. true: 유효, false: 만료 또는 폐기됨
enabled	Boolean	사용 중 여부. true: 사용 중, false: 미사용

실패 응답

{
  "resultType": "FAIL",
  "error": {
    "errorType": 0,
    "errorCode": "CE1000",
    "reason": "토큰이 유효하지 않습니다"
  }
}