POPBill Developers
API Reference

5. 인증서 관리

5.1. GetTaxCertURL - 인증서 등록 팝업 URL

  • 전자세금계산서 발행에 필요한 공동인증서를 팝빌 인증서버에 등록하기 위한 페이지의 팝업 URL을 반환합니다.
  • 반환되는 URL은 보안 정책상 30초 동안 유효하며, 시간을 초과한 후에는 해당 URL을 통한 페이지 접근이 불가합니다.
String getTaxCertURL(String CorpNum, String UserID) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID String 50 N 팝빌회원 아이디
Return

String - 요청에 대한 응답 URL

Throws

PopbillException

5.2. RegistTaxCert - 인증서 등록

  • 전자세금계산서 발행에 필요한 공동인증서를 팝빌 인증서버에 등록합니다.
  • 공동인증서는 팝빌에서 발급하는 '표준 인증서', 은행에서 발급하는 '전자세금용 인증서' 또는 '기업범용 인증서'만 등록 가능합니다.
  • 공동인증서 정보는 통신 구간의 보안을 위해 필드 레벨 암호화(FLE)되어 처리됩니다.

    ※ 통신구간 암호화 키 발급은 파트너 센터(1600-8536)로 문의하여 주시기 바랍니다.

  • 공동인증서 비밀번호의 안전한 관리를 위해 DB 저장시 컬럼 암호화 하여 저장합니다.
Response RegistTaxCert(String CorpNum, String certPublicKey, String certPrivateKey, String certCipher, String UserID) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
certPublicKey String - Y 공동인증서 공개키
Base64 Encoded
certPrivateKey String - Y 공동인증서 개인키
Base64 Encoded
certCipher String - Y 공동인증서 비밀번호
UserID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException

5.3. RegistTaxCertPFX - PFX 인증서 등록

  • 전자세금계산서 발행에 필요한 공동인증서를 팝빌 인증서버에 등록합니다.
  • 공동인증서는 팝빌에서 발급하는 '표준 인증서', 은행에서 발급하는 '전자세금용 인증서' 또는 '기업범용 인증서'만 등록 가능합니다.
  • 공동인증서 정보는 통신 구간의 보안을 위해 필드 레벨 암호화(FLE)되어 처리됩니다.

    ※ 통신구간 암호화 키 발급은 파트너 센터(1600-8536)로 문의하여 주시기 바랍니다.

  • 공동인증서 비밀번호의 안전한 관리를 위해 DB 저장시 컬럼 암호화 하여 저장합니다.
Response RegistTaxCertPFX(String CorpNum, String PFX, String password, String UserID) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
PFX String - Y 공동인증서 PFX 파일
Base64 Encoded
password String - Y 공동인증서 PFX 파일 비밀번호
UserID String 50 N 팝빌회원 아이디
Return

Response

Throws

PopbillException

5.4. GetCertificateExpireDate - 인증서 만료일 확인

  • 팝빌 인증서버에 등록된 공동인증서의 만료일을 확인합니다.
Date getCertificateExpireDate(String CorpNum) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
Return

Date - 공동인증서 만료일자 (형식 : yyyyMMdd)

Throws

PopbillException

5.5. CheckCertValidation - 인증서 유효성 확인

  • 팝빌 인증서버에 등록된 공동인증서의 유효성을 확인합니다.
Response checkCertValidation(String CorpNum) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
Return

Response

Throws

PopbillException

5.6. GetTaxCertInfo - 인증서 정보 확인

  • 팝빌 인증서버에 등록된 공동인증서의 정보를 확인합니다.
TaxinvoiceCertificate GetTaxCertInfo(String CorpNum, String UserID) throws PopbillException
Parameters
순번변수명타입길이필수설명
CorpNum String 10 Y 팝빌회원 사업자번호 ('-' 제외)
UserID String 50 N 팝빌회원 아이디
Return

TaxinvoiceCertificate

Throws

PopbillException