현금영수증 취소

발행한 현금영수증은 취소할 수 있어요. 결제 건에 발행​​한 영수증과 별건 발행​​한 영수증은 취소 엔드포인트가 달라요. 발행 시 사용한 방식에 맞춰 호출해요.

모두 서버에서 Basic Auth로 호출해요.

1결제 건 발행분 취소

결제 건에 발행한 현금영수증을 취소해요. 취소 대상은 결제의 receipt_id예요.

curl -X DELETE "https://api.bootpay.co.kr/v2/request/receipt/cash/cancel/RECEIPT_ID" \
  -H "Authorization: Basic $(printf '%s' 'CLIENT_KEY:SECRET_KEY' | base64)"bash

import { Bootpay } from '@bootpay/backend-js'

Bootpay.setConfiguration({
    client_key: process.env.BOOTPAY_CLIENT_KEY,
    secret_key: process.env.BOOTPAY_SECRET_KEY,
})

await Bootpay.cashReceiptCancelOnReceipt({
    receipt_id: '[ receipt_id ]',
})
// 성공 시 HTTP 200, 본문은 JSON 리터럴 null 이에요.javascript

2별건 발행분 취소

별건 발행한 현금영수증을 취소해요. 취소 대상은 별건 발행 응답에서 받은 receipt_id예요.

curl -X DELETE "https://api.bootpay.co.kr/v2/request/cash/receipt/RECEIPT_ID" \
  -H "Authorization: Basic $(printf '%s' 'CLIENT_KEY:SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{ "cancel_username": "홍길동", "cancel_message": "오발행 취소" }'bash

const response = await Bootpay.cancelCashReceipt({
    receipt_id: '[ receipt_id ]',
    cancel_username: '홍길동',
    cancel_message: '오발행 취소',
})
console.log(response.status) // status 61: 발행취소javascript

응답 예시

{
  "receipt_id": "62f356871fc192036f9f4ae2",
  "order_id": "cash_1700000000",
  "price": 10000,
  "tax_free": 0,
  "cancelled_price": 10000,
  "cancelled_tax_free": 0,
  "order_name": "현장 수령 현금결제",
  "company_name": "테스트상점",
  "gateway_url": "https://api.bootpay.co.kr",
  "metadata": {},
  "sandbox": false,
  "pg": "나이스페이먼츠",
  "method": "현금영수증",
  "method_symbol": "cash_receipt",
  "method_origin": "현금영수증",
  "method_origin_symbol": "cash_receipt",
  "purchased_at": "2026-04-10T15:56:08+09:00",
  "cancelled_at": "2026-04-10T17:27:20+09:00",
  "requested_at": "2026-04-10T15:56:02+09:00",
  "status_locale": "현금영수증발행취소",
  "currency": "KRW",
  "status": 61,
  "cash_receipt_data": {
    "tid": "Ae75jWNka9lpP2YxJ4K87RXb62PYLrRGZwXLObgyB0vMDm1d",
    "cash_receipt_type": 1,
    "cash_receipt_no": "158190158",
    "receipt_url": "https://.../receipts/cash-receipt/..."
  }
}json

에러 코드