Cash Receipt Webhooks

For delivery method, firewall settings, and logs, see Webhook Events.

Event Types

Cash receipt issuance and cancellation are asynchronous. The API sends the final result in one of the following events.

Event Type	Description
`CASH_RECEIPT_ISSUED`	Issuance succeeded
`CASH_RECEIPT_ISSUE_FAILED`	Issuance failed
`CASH_RECEIPT_CANCELED`	Cancellation succeeded
`CASH_RECEIPT_CANCEL_FAILED`	Cancellation failed
`CASH_RECEIPT_EXTERNALLY_CANCELED`	Canceled outside Bolta

Payload

Issuance Success

{
  "eventType": "CASH_RECEIPT_ISSUED",
  "data": {
    "issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I",
    "cashReceiptApprovalNumber": "123456789012"
  }
}

Field	Type	Description
`eventType`	string	Event type
`data.issuanceKey`	string	Issuance key
`data.cashReceiptApprovalNumber`	string	Cash receipt approval number

Issuance Failure

{
  "eventType": "CASH_RECEIPT_ISSUE_FAILED",
  "data": {
    "issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I",
    "cause": {
      "code": "INVALID_RECIPIENT_IDENTIFIER",
      "message": "현금영수증 발급 수단 정보를 확인해주세요."
    }
  }
}

Field	Type	Description
`eventType`	string	Event type
`data.issuanceKey`	string	Issuance key
`data.cause.code`	string	Failure code
`data.cause.message`	string	Failure reason returned in Korean

Cancellation Success

{
  "eventType": "CASH_RECEIPT_CANCELED",
  "data": {
    "issuanceKey": "9XK21ABC5KOAEIPGK8U6UO05I3EAQPLI8OE78Z1Q",
    "originalIssuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
  }
}

Field	Type	Description
`eventType`	string	Event type
`data.issuanceKey`	string	Issuance key for the cancellation request
`data.originalIssuanceKey`	string	Original issuance key of the canceled receipt

Cancellation Failure

{
  "eventType": "CASH_RECEIPT_CANCEL_FAILED",
  "data": {
    "issuanceKey": "9XK21ABC5KOAEIPGK8U6UO05I3EAQPLI8OE78Z1Q",
    "originalIssuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I",
    "cause": {
      "code": "ORIGINAL_ISSUANCE_FAILED",
      "message": "원본 현금영수증 발행이 실패해 취소 요청을 처리할 수 없습니다."
    }
  }
}

Field	Type	Description
`eventType`	string	Event type
`data.issuanceKey`	string	Issuance key for the cancellation request
`data.originalIssuanceKey`	string	Original issuance key of the receipt being canceled
`data.cause.code`	string	Failure code
`data.cause.message`	string	Failure reason returned in Korean

The following codes are returned only with CASH_RECEIPT_CANCEL_FAILED.

ORIGINAL_ISSUANCE_FAILED: Bolta accepted the cancellation request while the original issuance was in progress, but the original issuance later failed
CANCELLATION_TARGET_NOT_FOUND: The cancellation target could not be found, was already canceled, or already had a cancellation request

Canceled Outside Bolta

Bolta sends this event when an issued cash receipt is canceled outside Bolta (for example, on Hometax).

{
  "eventType": "CASH_RECEIPT_EXTERNALLY_CANCELED",
  "data": {
    "issuanceKey": "MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"
  }
}

Field	Type	Description
`eventType`	string	Event type
`data.issuanceKey`	string	Issuance key of the cash receipt canceled outside Bolta

Webhook Delivery Time

Delivery timing depends on the key and processing result. For live keys, Bolta starts result-webhook delivery after the final status changes.

Event	Delivery time
`CASH_RECEIPT_ISSUED`	After the issuance result is final. A live issuance can be finalized after 17:00 KST on the day following the request.
`CASH_RECEIPT_ISSUE_FAILED`	After the issuance failure is final.
`CASH_RECEIPT_CANCELED`, `CASH_RECEIPT_CANCEL_FAILED`	After the cancellation result is final.
`CASH_RECEIPT_EXTERNALLY_CANCELED`	After the external cancellation is confirmed.

A test key (test_) records the final status after the request is processed. The automatic webhook is sent no sooner than 10 seconds after the API accepts the request. You can receive the same event more than once. Process webhooks idempotently with eventType and issuanceKey. The final status transition and HTTP receipt do not necessarily occur at the same time.

202 Accepted only means Bolta accepted the request. Treat a cash receipt as unconfirmed until the status API returns ISSUED or you receive CASH_RECEIPT_ISSUED.

When a Webhook Does Not Arrive

Check with Retrieve Cash Receipt Status. PENDING means the API accepted the request and has not started processing it. REQUEST_SUCCESS only means request delivery completed; it does not confirm the final result. For a live request that remains in progress or awaits issuance-result confirmation, check again after 17:00 KST on the following day.

API Introduction

API Guides

Use Cases

SDK / No-code

Event Types

Payload

Issuance Success

Issuance Failure

Cancellation Success

Cancellation Failure

Canceled Outside Bolta

Webhook Delivery Time

When a Webhook Does Not Arrive

​Event Types

​Payload

​Issuance Success

​Issuance Failure

​Cancellation Success

​Cancellation Failure

​Canceled Outside Bolta

​Webhook Delivery Time

​When a Webhook Does Not Arrive

Event Types

Payload

Issuance Success

Issuance Failure

Cancellation Success

Cancellation Failure

Canceled Outside Bolta

Webhook Delivery Time

When a Webhook Does Not Arrive