웹훅(Webhook) 연결하기
웹훅 사용하기
1. 웹훅 이벤트 타입을 알아보세요
| 이벤트 타입 | 설명 |
|---|---|
TAX_INVOICE_ISSUANCE_SUCCESS | 전자세금계산서 발행에 성공했을 때 발생되는 이벤트입니다. |
TAX_INVOICE_ISSUANCE_FAILURE | 전자세금계산서 발행에 실패했을 때 발생되는 이벤트입니다. |
2. 웹훅 이벤트를 등록하세요
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": "공동인증서가 등록되지 않았습니다."
}
}
}