Error Codes - 볼타 사용 가이드

Tax invoice issuance API

Status code	Error code	Message
`400`	`NOT_FOUND_CERTIFICATE`	No certificate is registered.
`400`	`INVALID_TRUSTEE_BUSINESS`	Invalid trustee business registration number.
`400`	`INVALID_SUPPLIER_BUSINESS`	No issuer is registered under the current API key.

Tax invoice issuance webhook

Error code	Message
`INVALID_SUPPLIER_BUSINESS`	The supplier’s business registration number is invalid (unregistered or closed).
`INVALID_SUPPLIED_BUSINESS`	The recipient’s business registration number is invalid.
`INVALID_TRUSTEE_BUSINESS`	The trustee’s business registration number is invalid (unregistered or closed).
`INTERNAL_SERVER_ERROR`	An error occurred on the Bolta server.
`INVALID_CERTIFICATE`	The registered certificate is invalid (expired or revoked).

Issuer registration API

Status code	Error code	Message
`400`	`INVALID_SUPPLIER_BUSINESS`	Invalid business registration number.

Cash receipt API

Status code	Error code	Condition
`400`	`INVALID_REQUEST`	Request validation or cancellation eligibility failed
`401`	-	API key authentication failed. Empty response body
`403`	`FORBIDDEN`	The client does not have access to the issuer
`409`	`IDEMPOTENCY_CONFLICT`	Idempotency conflict, cancellation before issuance processing starts, or duplicate active cancellation
`500`	`INTERNAL_SERVER_ERROR`	Internal server error
`503`	`SERVICE_UNAVAILABLE`	Internal API communication error during issuance or cancellation

Cash receipt webhook

When cash receipt issuance or cancellation fails, the API includes one of the following codes in data.cause.code in the webhook payload and failure.code in the status response.

Error code	Payload message
`INVALID_ISSUER`	공급자 정보 또는 현금영수증 발행 등록 상태를 확인해주세요.
`INVALID_RECIPIENT_IDENTIFIER`	현금영수증 발급 수단 정보를 확인해주세요.
`ORIGINAL_ISSUANCE_FAILED`	원본 현금영수증 발행이 실패해 취소 요청을 처리할 수 없습니다.
`CANCELLATION_TARGET_NOT_FOUND`	이미 취소되었거나 취소할 수 없는 거래입니다.
`UNKNOWN`	현금영수증 처리에 실패했습니다. 문제가 계속되면 고객센터로 문의해주세요.

ORIGINAL_ISSUANCE_FAILED and CANCELLATION_TARGET_NOT_FOUND 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

Common errors

Status code	Error code	Message
`400`	`INVALID_REQUEST`	The request could not be processed. This response is returned when a required parameter is missing or a parameter format is invalid. Check your request parameters.
`404`	`NOT_FOUND`	The requested resource does not exist. Double-check the API address you requested.
`500`	`INTERNAL_SERVER_ERROR`	An error occurred on the Bolta server.