현금영수증 발급 취소

POST /v1/cash-receipts/{id}/revoke 로 국세청 처리를 기다리는 현금영수증의 발급을 취소해요.

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

status가 PENDING인 현금영수증의 발급을 취소해요. 취소하면 status가 REVOKED로 바뀌어요.

ISSUED, FAILED, REVOKED 상태에서는 취소할 수 없고 CASH_RECEIPT_ALREADY_ISSUED가 와요. 국세청 발급이 끝난 현금영수증을 취소해야 한다면 paysync.kr 상담 위젯으로 문의하세요.

경로 파라미터

파라미터	타입	설명
`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`	다른 계정의 현금영수증이에요.
404	`CASH_RECEIPT_NOT_FOUND`	현금영수증이 없어요.
409	`CASH_RECEIPT_ALREADY_ISSUED`	`PENDING` 상태가 아니에요.
500	`POPBILL_API_FAILED`	팝빌 호출이 실패했어요. 잠시 뒤 다시 시도하세요.