인증서 상태 이벤트

공동인증서 등록/재등록/삭제에서 발생하는 이벤트입니다.

이벤트 유형	설명
REGIST	공동인증서 등록/재등록
DELETE	공동인증서 삭제

Webhook - Header

필드명	설명	필수	예시
Pb-Webhook-Type	Webhook 유형	Y	TAXINVOICE.CERT
Pb-Webhook-MID	이벤트 식별값	Y	023090000119-9fbe872872d34ab3be38417
Pb-Webhook-Corpnum	팝빌 사업자번호	Y	6798700433
Content-Type	Webhook 메시지 Body 타입	Y	application/json
Authorization	Base64 인코딩한 BASIC 인증정보	N	Basic VEVTVDoxMjM= HTTP 인증 사용하는 경우 추가 항목
X-Api-Key	API Key 인증정보	N	TESTAPIKEY HTTP 인증 사용하는 경우 추가 항목
Pb-Webhook-EventType	Webhook 메시지 Event 타입	N	REGIST

팝빌은 기본으로 제공되는 Header 필드 외 프로그램 공급사 운영환경에 맞춘 커스텀 필드 지원이 가능합니다.
커스텀 필드 추가가 필요한 경우 팝빌 기술지원센터(1600-9854)로 문의주시기 바랍니다.

Webhook - Body

필드명	타입	길이	필수	설명
corpNum	String	10	Y	팝빌회원 사업자번호
expireDT	String	14	N	공동인증서 만료일시 형식 : yyyyMMddHHmmss
regContactID	String	50	N	공동인증서를 등록한 팝빌 담당자 아이디
issuerDN	String	200	N	발급자 DN
subjectDN	String	200	N	인증서 DN
eventDT	String	14	Y	이벤트 실행일시 형식 : yyyyMMddHHmmss
eventType	String	30	Y	이벤트 유형 REGIST등록/재등록 DELETE삭제
oid	String	30	N	OID

이벤트 예시

공동인증서 등록/재등록/삭제 웹훅에서 발생하는 이벤트 예시입니다.

실제 고객사 서버로 전송된 웹훅 이벤트 정보는 [Webhook 실행내역 확인] 을 참고하여 주시기 바랍니다.

REGIST
DELETE

등록/재등록

공동인증서를 등록/재등록 하는 시점에 실행됩니다.

{
  "corpNum": "1234567890",
  "expireDT": "20250706145209",
  "regContactID": "linkhub",
  "issuerDN": "CN=Root CA, OU=Certification Authority, O=Organaization, C=KR",
  "eventType": "REGIST",
  "oid": "1.2.410.200004.5.1.1.5",
  "eventDT": "20250623135523",
  "subjectDN": "CN=홍길동, OU=Organaization Unit, O=Organaization, C=KR"
}

삭제

공동인증서를 삭제 하는 시점에 실행됩니다.

{
  "corpNum": "1234567890",
  "eventType": "DELETE",
  "eventDT": "20250623135523"
}