홈택스 현금영수증 발행과 당일 취소 자동화
구매자 휴대전화번호로 소득공제용 현금영수증을 즉시 발행하고, 당일 발급분은 클릭 한 번으로 취소하세요. PRO 요금제에서는 REST API로 결제 시스템과 바로 연동할 수 있습니다.
건별 수기 입력에서 벗어나 발행을 자동화하세요
국세청 홈택스에서 현금영수증을 발행하려면 매 거래마다 로그인해 금액과 발급수단을 직접 입력해야 합니다. 거래가 많아질수록 누락과 오입력, 그리고 당일 취소 기한을 놓치는 리스크가 커집니다.
DI홈택스는 화면과 REST API로 현금영수증 발행·조회·당일 취소를 자동화합니다. 쇼핑몰·POS·ERP에서 결제가 완료되는 즉시 현금영수증이 발행되도록 연결할 수 있습니다.
홈택스 수기 발행
건별 로그인·입력, 취소 기한 수동 관리
DI홈택스 자동화
웹·API 발행, 당일 취소 자동 판별
현금영수증 발행 프로세스
최초 1회 인증서만 등록하면, 이후 발행·조회·취소를 웹과 API 어디서나 처리할 수 있습니다.
- 01
인증서 등록 (최초 1회)
국세청 홈택스 자동 연동을 위해 공동인증서를 한 번 등록합니다.
- 02
발급번호·금액 입력
구매자 휴대전화번호(소득공제) 또는 사업자등록번호(지출증빙)와 거래금액을 입력하고 과세·면세 유형을 선택하면 발행됩니다.
- 03
조회 및 당일 취소
발급 내역에서 승인번호와 상태를 확인하고, 당일 발급분은 클릭 한 번으로 취소할 수 있습니다.
결제 시스템에 바로 연동하는 현금영수증 API
X-API-Key 인증 방식의 REST API로 발행·상태 조회·당일 취소를 자동화합니다. 멱등키(idempotency_key)로 이중 발행을 방지하며, 발행 완료 시 승인번호와 금액을 즉시 응답합니다. 현금영수증 API는 PRO 요금제(유료 구독)에서 제공됩니다.
- POST 발행 · GET 조회 · DELETE 당일 취소
- 멱등키 기반 이중 발행 방지
- 과세·면세 거래유형 지원
POST /api/v1/cash-receipts
X-API-Key: dk_xxxx...
{
"phone": "010-1234-5678",
"total_amount": 11000,
"tax_type": "과세",
"idempotency_key": "order-12345"
}
# 응답
{
"success": true,
"receipt_key": "…",
"aprv_no": "Z59924022",
"supply_amount": 10000,
"vat_amount": 1000,
"total_amount": 11000
}현금영수증 발행 자주 묻는 질문 (FAQ)
현금영수증을 API로 발행할 수 있나요?
네, PRO 요금제(유료 구독)에서 가능합니다. DI홈택스는 X-API-Key 인증 기반의 REST API를 제공하여 현금영수증 발행(POST /api/v1/cash-receipts), 상태 조회, 당일 취소를 프로그래밍 방식으로 처리할 수 있습니다. ERP·쇼핑몰·POS 시스템에 연동해 결제와 동시에 현금영수증을 자동 발행할 수 있습니다. 화면에서 직접 발행하는 기능은 모든 요금제에서 사용할 수 있습니다.
현금영수증 발급수단은 무엇을 지원하나요?
휴대전화번호와 사업자등록번호를 지원합니다. 휴대전화번호로는 소득공제용, 사업자등록번호로는 지출증빙용 현금영수증이 발행되며, 과세·면세 거래유형을 모두 선택할 수 있습니다. 현금영수증 카드번호는 지원하지 않습니다.
발행한 현금영수증을 당일에 취소할 수 있나요?
네, 발급 당일에 한해 취소가 가능합니다. 국세청 홈택스 정책상 당일 발급분만 취소할 수 있으며, 익일 이후 건은 취소가 불가합니다. DI홈택스는 발급 내역에서 당일 취소 가능 여부를 자동으로 판별해 안전하게 처리합니다.
현금영수증 발행을 위해 필요한 준비물은 무엇인가요?
최초 1회 국세청 연동을 위한 공동인증서(구 공인인증서) 등록이 필요합니다(금융인증서는 지원하지 않습니다). 한 번 등록해 두면 이후에는 별도의 홈택스 로그인 없이 웹 또는 API로 바로 발행할 수 있습니다.
발급 내역을 조회할 수 있나요?
네, 발급한 현금영수증의 승인번호, 거래일시, 발급수단, 공급가액·부가세·총액, 발행/취소 상태를 발급 내역 화면과 목록 조회 API(GET /api/v1/cash-receipts, PRO 요금제)에서 확인할 수 있습니다.