Skip to main content
For delivery method, retry policy, 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.

Payload

Issuance Success

Issuance Failure

Cancellation Success

Cancellation Failure

The following codes appear only in 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 or was already canceled. This also applies when it was fully or partially canceled outside Bolta (for example, on Hometax) 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).

Webhook Delivery Time

A test key (test_) records the final status as soon as the request is processed, and Bolta sends the webhook no sooner than 10 seconds after accepting the request.
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. For a live request that remains in progress or awaits issuance-result confirmation, check again after 17:00 KST on the following day.