현금영수증 발급 취소

POST /v1/cash-receipts/{id}/revoke 로 국세청 발급이 끝난 현금영수증의 남은 금액 전체를 취소해요.

POST /v1/cash-receipts/{id}/revoke

status가 ISSUED인 현금영수증의 남은 금액 전체를 취소해요. 페이싱크가 취소 사유 “거래 취소”로 취소 현금영수증을 발급하고, 원본의 status는 REVOKED로 바뀌어요.

금액 일부만 취소하려면 v2 현금영수증 취소를 쓰세요.

경로 파라미터

파라미터	타입	설명
`id`	string	취소할 현금영수증 ID예요. `crt_`로 시작해요.

요청 예시

curl -X POST https://api.paysync.kr/v1/cash-receipts/crt_a1b2c3d4e5f6g7h8i9j0k1l2/revoke \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"

const res = await fetch(`https://api.paysync.kr/v1/cash-receipts/${cashReceiptId}/revoke`, {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}` },
});
const { code } = await res.json();

import os
import requests

res = requests.post(
    f"https://api.paysync.kr/v1/cash-receipts/{cash_receipt_id}/revoke",
    headers={"Authorization": f"Bearer {os.environ['PAYSYNC_API_KEY']}"},
)
print(res.json())

응답

{
  "code": "OK",
  "data": null
}

오류

HTTP	`code`	발생 조건
401	`NOT_AUTHORIZED`	API 키가 없거나 올바르지 않아요.
403	`INSUFFICIENT_PERMISSIONS`	읽기 전용 API 키예요.
404	`CASH_RECEIPT_NOT_FOUND`	현금영수증이 없어요.
409	`CASH_RECEIPT_NOT_REVOCABLE`	`ISSUED` 상태가 아니에요.
500	`POPBILL_API_FAILED`	팝빌이 취소 요청을 거절했거나 팝빌 호출이 실패했어요. 원본은 그대로 `ISSUED`로 남아요.