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

인증

Authorization
string
header
필수

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

헤더

Bolta-Client-Reference-Id
string
필수

발행 요청과 다른 1~255자의 요청자 관리번호를 입력하세요. 이 값은 취소 요청의 멱등키로 사용합니다. 같은 API 키와 요청자 관리번호로 동일한 취소 요청을 다시 호출하면 API가 기존 접수 건의 issuanceKey를 담은 202 Accepted 응답을 반환합니다. 요청 내용이나 유형이 다르면 409 ConflictIDEMPOTENCY_CONFLICT를 반환합니다. 상태를 다시 조회할 때 이 값을 clientReferenceId에 입력하세요.

Required string length: 1 - 255
Pattern: \S
Bolta-Webhook-Test-Code
enum<string>

테스트 키에서 취소 실패 웹훅을 재현할 때만 사용하세요. 취소 실패 코드를 입력하면 API가 해당 실패 웹훅을 전송합니다. 운영(라이브)에서는 사용하지 마세요. 현금영수증 웹훅

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

경로 매개변수

issuanceKey
string
필수

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

응답

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

issuanceKey
string
필수

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

예시:

"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"

originalIssuanceKey
string
필수

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

예시:

"MRK98JGC5KOAEIPGK8U6UO05I3EAQPLI8OE78A3I"