웹훅(Webhook) 연결하기

웹훅은 데이터가 변경되었을 때 파트너 서버에서 실시간으로 알림을 받을 수 있는 기능입니다. 웹훅을 연동해서 전자세금계산서 발행 상태 업데이트와 같은 변경 사항을 실시간으로 받아보세요.

웹훅 사용하기

1. 웹훅 이벤트 타입을 알아보세요

웹훅으로 등록할 수 있는 이벤트 타입은 아래와 같습니다.

이벤트 타입	설명
`TAX_INVOICE_ISSUANCE_SUCCESS`	전자세금계산서 발행에 성공했을 때 발생되는 이벤트입니다.
`TAX_INVOICE_ISSUANCE_FAILURE`	전자세금계산서 발행에 실패했을 때 발생되는 이벤트입니다.

2. 웹훅 이벤트를 등록하세요

웹훅은 테스트 환경과 라이브 환경 각각 별개로 등록하여야 합니다.

웹훅 등록 가이드: https://docs.bolta.io/docs/%EC%9B%B9%ED%9B%85-%EC%97%B0%EA%B2%B0%ED%95%98%EA%B8%B0

로컬 환경에서 웹훅을 받을 수 있나요?

이벤트는 어떤 형식인가요?

3. 전자세금계산서 발행 성공/실패 시 웹훅이 발송됩니다.

라이브 키를 이용하는 경우 웹훅 발송까지 15분 가량 소요되며, 테스트 키를 이용하는 경우 전자세금계산서 발행 요청 10초 ~ 30초 뒤 웹훅이 발송됩니다.

이벤트 타입

TAX_INVOICE_ISSUANCE_SUCCESS

전자세금계산서 발행 성공을 알려주는 웹훅입니다.

이벤트 본문

{
  "eventType": "TAX_INVOICE_ISSUANCE_SUCCESS",
  "data": {
    "issuanceKey": "IssuanceKey_0FE29D3930EF0C6F01J0XQ6WVFN3K9SB99Q6T13S50",
    "taxInvoiceUrl": "https://app.bolta.io/taxInvoices/..."
  }
}

TAX_INVOICE_ISSUANCE_FAILURE

전자세금계산서 발행 실패를 알려주는 웹훅입니다.

이벤트 본문

{
  "eventType": "TAX_INVOICE_ISSUANCE_FAILURE",
  "data": {
    "issuanceKey": "IssuanceKey_0FE29D3930EF0C6F01J0XQ6WVFN3K9SB99Q6T13S50",
    "cause": {
      "code": "NOT_FOUND_CERTIFICATE",
      "message": "공동인증서가 등록되지 않았습니다."
    }
  }
}

웹훅(Webhook) 연결하기

웹훅 사용하기#

1. 웹훅 이벤트 타입을 알아보세요#

2. 웹훅 이벤트를 등록하세요#

3. 전자세금계산서 발행 성공/실패 시 웹훅이 발송됩니다.#

이벤트 타입#

TAX_INVOICE_ISSUANCE_SUCCESS#

이벤트 본문#

TAX_INVOICE_ISSUANCE_FAILURE#

이벤트 본문#

웹훅 사용하기

1. 웹훅 이벤트 타입을 알아보세요

2. 웹훅 이벤트를 등록하세요

3. 전자세금계산서 발행 성공/실패 시 웹훅이 발송됩니다.

이벤트 타입

TAX_INVOICE_ISSUANCE_SUCCESS

이벤트 본문

TAX_INVOICE_ISSUANCE_FAILURE

이벤트 본문