현금영수증 발행

현금영수증은 두 가지로 발행해요. 이미 완료된 결제 건에 붙이는 결제 건 발행​, 결제와 무관하게 단독으로 발행하는 별건 발행​​이에요. 모두 서버에서 Basic Auth로 호출해요.

발행 유형(소득공제/지출증빙)과 identity_no 규칙은 현금영수증 개요를 참고해요.

1결제 건에 발행

완료된 결제의 receipt_id에 현금영수증을 발행해요. 계좌이체·가상계좌처럼 현금성 결제를 한 뒤 영수증만 따로 발행할 때 사용해요.

curl -X POST "https://api.bootpay.co.kr/v2/request/receipt/cash/publish" \
  -H "Authorization: Basic $(printf '%s' 'CLIENT_KEY:SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "receipt_id": "RECEIPT_ID",
    "cash_receipt_type": "소득공제",
    "identity_no": "01012345678",
    "username": "홍길동",
    "phone": "01012345678"
  }'bash

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

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

const response = await Bootpay.cashReceiptPublishOnReceipt({
    receipt_id: '[ receipt_id ]',
    cash_receipt_type: '소득공제',       // 소득공제 | 지출증빙
    identity_no: '01012345678',          // 휴대폰번호 / 주민번호 / 사업자번호
    username: '홍길동',
    phone: '01012345678',
    email: 'user@example.com',
})
console.log(response.bank_data.cash_receipt_no, response.bank_data.cash_receipt_url)javascript

응답 예시

응답은 결제 건 전체 정보​​를 그대로 돌려주고, 현금영수증 정보는 그 안의 결제수단 블록에 담겨요. 원 결제가 계좌이체면 bank_data, 가상계좌면 vbank_data 안에 cash_receipt_* 필드가 들어가요.

{
  "receipt_id": "62f356871fc192036f9f4ae2",
  "order_id": "order_1700000000",
  "price": 10000,
  "tax_free": 0,
  "cancelled_price": 0,
  "cancelled_tax_free": 0,
  "order_name": "테스트 결제",
  "company_name": "테스트상점",
  "gateway_url": "https://api.bootpay.co.kr",
  "metadata": {},
  "sandbox": false,
  "pg": "나이스페이먼츠",
  "method": "계좌이체",
  "method_symbol": "bank",
  "method_origin": "계좌이체",
  "method_origin_symbol": "bank",
  "purchased_at": "2026-04-10T15:56:08+09:00",
  "requested_at": "2026-04-10T15:55:41+09:00",
  "status_locale": "결제완료",
  "currency": "KRW",
  "receipt_url": "https://.../receipts/...",
  "status": 1,
  "bank_data": {
    "tid": "5zJ4xY7m0kODnyRpQWGrNWja7bkR78Kwv1M9ENjbeoPaZdL6",
    "bank_code": "088",
    "bank_name": "신한",
    "cash_receipt_tid": "AxMBvpmjnoD4yKeq5bgrp5QbZ7MqQ8GX0lzW6YOQJ1w9NLRZ",
    "cash_receipt_type": 1,
    "cash_receipt_no": "158190158",
    "cash_receipt_url": "https://.../receipts/cash-receipt/..."
  }
}json

2별건 발행

결제와 무관하게 현금영수증만 단독으로 발행해요. 오프라인에서 현금을 직접 수령한 경우 등에 사용해요.

curl -X POST "https://api.bootpay.co.kr/v2/request/cash/receipt" \
  -H "Authorization: Basic $(printf '%s' 'CLIENT_KEY:SECRET_KEY' | base64)" \
  -H "Content-Type: application/json" \
  -d '{
    "pg": "나이스페이먼츠",
    "order_name": "현장 수령 현금결제",
    "order_id": "cash_1700000000",
    "price": 10000,
    "tax_free": 0,
    "identity_no": "01012345678",
    "cash_receipt_type": "소득공제",
    "user": { "username": "홍길동", "phone": "01012345678" }
  }'bash

const response = await Bootpay.requestCashReceipt({
    pg: '나이스페이먼츠',
    order_name: '현장 수령 현금결제',
    order_id: 'cash_' + Date.now(),
    price: 10000,
    tax_free: 0,
    identity_no: '01012345678',
    cash_receipt_type: '소득공제',
    user: {
        username: '홍길동',
        phone: '01012345678',
        email: 'user@example.com',
    },
})
console.log(response.receipt_id, response.status) // status 60: 발행완료javascript

응답 예시

{
  "receipt_id": "62f356871fc192036f9f4ae2",
  "order_id": "cash_1700000000",
  "price": 10000,
  "tax_free": 0,
  "cancelled_price": 0,
  "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",
  "requested_at": "2026-04-10T15:56:02+09:00",
  "status_locale": "현금영수증발행완료",
  "currency": "KRW",
  "status": 60,
  "cash_receipt_data": {
    "tid": "Ae75jWNka9lpP2YxJ4K87RXb62PYLrRGZwXLObgyB0vMDm1d",
    "cash_receipt_type": 1,
    "cash_receipt_no": "158190158",
    "receipt_url": "https://.../receipts/cash-receipt/..."
  }
}json

cash_receipt_data의 필드는 다음과 같아요.

별건 발행은 receipt_id를 새로 발급받아요. 이 receipt_id로 현금영수증 취소를 호출할 수 있으므로 저장해 두세요.

에러 코드

별건 발행에서 추가로 발생하는 에러

별건 발행은 영수증을 새로 만들기 때문에 결제 요청과 같은 기본 검증을 함께 거쳐요.

다음 단계

• 발행한 현금영수증을 취소하려면 현금영수증 취소을 확인해요.