---
title: 현금영수증 발급
description: 사업자 정보 등록, 입금 확인 시 자동 발급과 자진발급 설정, API로 직접 발급하기, 발급 실패와 재발급, 취소, 구매자에게 보내기까지 현금영수증 발급 흐름을 설명해요.
sidebar:
icon: receipt
---
페이싱크는 [팝빌](https://www.popbill.com/)을 통해 국세청에 현금영수증을 발급해요. 따로 계약할 필요 없이 사업자 정보만 등록하면 돼요. 요금제와 관계없이 발급할 수 있어요.
발급 방법은 두 가지예요.
| 방법 | 어울리는 경우 |
| --- | --- |
| [자동 발급](#자동-발급) | 주문을 만들 때 구매자의 현금영수증 정보를 받아 두고, 결제가 완료되면 페이싱크가 발급해요. |
| [직접 발급](#직접-발급) | 대시보드나 [현금영수증 발급 API](/api-reference/cash-receipts/issue)로 원하는 때에 발급해요. 주문 없이도 발급할 수 있어요. |
## 사업자 정보 등록
현금영수증을 발급하려면 소유자가 대시보드 **설정 > 일반**의 **사업자 정보**에서 **사업자 정보 등록**을 해야 해요. 사업자등록번호, 상호, 대표자, 업태, 종목, 주소, 연락처를 입력해요. 등록하면 **현금영수증 > 발급 설정**의 사업자 정보에 **국세청 연동됨**이 표시돼요.
사업자 정보 없이 발급하면 `409`, `240005`로 실패해요. 사업자등록번호는 바꿀 수 없어요. 바꾸려면 **국세청 연동 해제** 뒤 다시 등록해요.
## 발급 설정
대시보드 **현금영수증 > 발급 설정**에서 정해요. 설정은 소유자와 개발자가 바꿀 수 있어요.
| 설정 | 기본값 | 하는 일 |
| --- | --- | --- |
| **입금 확인 시 자동 발급** | 켜짐 | 주문이 결제 완료되면 현금영수증을 발급해요. |
| **요청 없는 주문은 자진발급** | 꺼짐 | 현금영수증 정보가 없는 주문도 **기준 금액** 이상이면 자진발급해요. 자동 발급이 켜져 있어야 쓸 수 있어요. |
| **기준 금액** | 100,000원 | 자진발급할 최소 금액이에요. |
| **과세 유형** | 과세 | **과세**는 금액의 11분의 1을 부가세로 나눠요. **면세**는 금액 전체가 공급가액이에요. |
| **발급 알림 메일** | 켜짐 | 주문과 연결된 현금영수증을 발급하면 구매자에게 메일을 보내요. |
| **상품명 표기** | `{워크스페이스명} 주문 #주문번호` | 현금영수증에 적을 상품명이에요. `#주문번호`는 실제 주문번호로 바뀌어요. |
현금영수증 발급 설정
## 자동 발급
주문을 만들 때 `cashReceipt`에 구매자가 요청한 현금영수증 정보를 넣어요.
```json
{
"customer": { "name": "홍길동", "email": "hong@example.com" },
"amount": 50000,
"cashReceipt": { "type": "PERSONAL", "identifier": "01012345678" }
}
```
| `type` | 용도 | `identifier` |
| --- | --- | --- |
| `PERSONAL` | 소득공제용 | 휴대폰 번호나 현금영수증 카드 번호, 10~18자리 숫자 |
| `CORPORATE` | 지출증빙용 | 사업자등록번호 10자리 |
하이픈과 공백은 빼고 검사해요. 형식이 틀리면 `220007`로 실패해요. 결제 대기 주문은 [주문 수정](/api-reference/invoices/update)으로 바꾸거나 `null`로 지울 수 있어요.
주문이 결제 완료되면 페이싱크가 결제된 금액(`paidAmount`)으로 현금영수증을 발급해요. 자동 매칭, 대시보드 직접 매칭, 결제 완료 처리 모두 해당해요.
:::warning
결제 완료 시점에 **입금 확인 시 자동 발급**이 꺼져 있거나 사업자 정보가 없으면 현금영수증을 만들지 않고, 기록도 남지 않아요. 나중에 설정을 켜도 이미 결제된 주문에는 발급하지 않으니, [직접 발급](#직접-발급)에 `invoiceId`를 넣어 발급하세요.
:::
### 자진발급
구매자가 현금영수증을 요청하지 않았어도 판매자는 국세청 지정 번호 `010-000-1234`로 자진발급할 수 있어요. **요청 없는 주문은 자진발급**을 켜면 `cashReceipt`가 없는 주문 중 **기준 금액** 이상인 주문에 자동으로 자진발급해요. 직접 발급할 때는 `selfIssued`를 `true`로 보내요. 자진발급은 `PERSONAL`만 돼요.
## 직접 발급
대시보드 **현금영수증**에서 발급하거나 [현금영수증 발급 API](/api-reference/cash-receipts/issue)를 호출해요. API는 읽기·쓰기 권한의 키로 호출해요. 대시보드에서는 소유자와 멤버가 발급해요.
- `invoiceId`를 넣으면 그 주문과 연결해요. 구매자 이름과 주문번호를 주문에서 가져오고, 구매자에게 발급 알림 메일을 보내요. 주문에 이미 발급 중이거나 발급된 현금영수증이 있으면 `240012`로 실패하고 `data.cashReceiptId`에 그 현금영수증 ID가 와요.
- `invoiceId` 없이 발급하면 금액을 자유롭게 정할 수 있고, 메일은 보내지 않아요.
- API는 주문의 상태나 금액을 검사하지 않아요. 결제 완료된 주문의 결제 금액으로 발급하세요.
## 발급 결과
현금영수증은 발급을 요청하면 바로 승인번호가 생기고, 국세청에는 다음 날 0시에 전송해요. 국세청 결과는 다음 날 오전 10시 이후에 반영돼요.
| `status` | 대시보드 | 뜻 |
| --- | --- | --- |
| `PENDING` | 전송 대기 | 발급 요청이 접수돼 국세청 전송을 기다려요. |
| `ISSUED` | 발급 완료 | 국세청에 발급됐어요. |
| `FAILED` | 발급 실패 | 팝빌이나 국세청이 거절했어요. 이유는 `failure`에 있어요. |
| `CANCELED` | 취소 영수증 | 원본을 취소한 취소 영수증이에요. |
발급 API는 거절당해도 `200`으로 응답하고 `status`가 `FAILED`인 현금영수증을 돌려줘요. 응답의 `status`를 꼭 확인하세요. 현금영수증 웹훅은 없어서, 국세청 결과는 [현금영수증 단건 조회](/api-reference/cash-receipts/get)로 확인해요.
### 재발급
발급에 실패한 원본은 `failure`의 안내를 보고 식별번호나 종류를 고쳐 [재발급](/api-reference/cash-receipts/reissue)할 수 있어요. 원본 하나에 한 번만 재발급할 수 있고, 금액, 구매자 이름, 연결된 주문은 원본을 그대로 써요. 실패는 자동으로 다시 시도하지 않아요.
### 취소
국세청에 발급된(`ISSUED`) 원본만 [취소](/api-reference/cash-receipts/cancel)할 수 있어요. 금액을 넣으면 그만큼만 부분 취소하고, 빼면 남은 금액을 모두 취소해요. 취소하면 취소 영수증이 따로 만들어져요. 국세청 전송을 기다리는 현금영수증은 다음 날 오전 10시 이후에 취소하세요.
주문을 취소하거나 매칭을 해제해도 현금영수증은 그대로예요. 환불했다면 현금영수증도 직접 취소하세요.
## 구매자에게 보내기
| 방법 | 설명 |
| --- | --- |
| 발급 알림 메일 | 주문과 연결된 현금영수증을 발급하면 주문의 `customer.email`로 자동으로 보내요. 국세청 결과를 기다리지 않고 발급 요청이 접수되면 바로 보내요. |
| [링크 조회](/api-reference/cash-receipts/urls) | 보기, 인쇄, PDF 링크를 받아 내 화면에서 보여 줘요. |
| [이메일 보내기](/api-reference/cash-receipts/send-email) | 원하는 주소로 현금영수증 메일을 보내요. |
발급에 실패한 현금영수증은 보낼 수 없어요.