Skip to main content
POST
현금영수증 취소

인증

Authorization
string
header
필수

API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.

헤더

Supplier-Key
string
필수

원본 발행에 사용한 공급자의 식별 키를 입력하세요. 용어 정리 | 인증 가이드

Bolta-Client-Reference-Id
string
필수

발행 요청과 다른 1~255자의 요청자 관리번호를 입력하세요. 이 값은 취소 요청의 멱등키로 사용합니다. 같은 값과 동일한 취소 요청으로 다시 호출하면 API가 기존 결과를 반환하고, 요청 내용이나 유형이 다르면 409 Conflict를 반환합니다. 상태를 다시 조회할 때 이 값을 clientReferenceId에 입력하세요.

Bolta-Webhook-Test-Code
enum<string>

테스트 키에서 실패 웹훅을 재현할 때만 사용하세요. 운영(라이브)에서는 사용하지 마세요.

사용 가능한 옵션:
INVALID_ISSUER,
INVALID_RECIPIENT_IDENTIFIER,
ORIGINAL_ISSUANCE_FAILED,
CANCELLATION_TARGET_NOT_FOUND,
UNKNOWN

경로 매개변수

issuanceKey
string
필수

발행 응답에서 받은 원본 현금영수증의 issuanceKey를 입력하세요.

응답

API가 취소 요청을 접수했습니다. 최종 결과는 웹훅이나 상태 조회 API로 확인하세요.

issuanceKey
string
필수

현금영수증 발행 식별 키입니다. 형식과 길이가 바뀔 수 있으므로 문자열 전체를 그대로 저장하세요.

예시:

"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"

originalIssuanceKey
string
필수

현금영수증 발행 식별 키입니다. 형식과 길이가 바뀔 수 있으므로 문자열 전체를 그대로 저장하세요.

예시:

"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"