현금영수증 발급

사업자 정보 등록, 입금 확인 시 자동 발급과 자진발급 설정, API로 직접 발급하기, 발급 실패와 재발급, 취소, 구매자에게 보내기까지 현금영수증 발급 흐름을 설명해요.

페이싱크는 팝빌을 통해 국세청에 현금영수증을 발급해요. 따로 계약할 필요 없이 사업자 정보만 등록하면 돼요. 요금제와 관계없이 발급할 수 있어요.

발급 방법은 두 가지예요.

사업자 정보 등록

현금영수증을 발급하려면 소유자가 대시보드 설정 > 일반의 사업자 정보에서 사업자 정보 등록을 해야 해요. 사업자등록번호, 상호, 대표자, 업태, 종목, 주소, 연락처를 입력해요. 등록하면 현금영수증 > 발급 설정의 사업자 정보에 국세청 연동됨이 표시돼요.

사업자 정보 없이 발급하면 409, 240005로 실패해요. 사업자등록번호는 바꿀 수 없어요. 바꾸려면 국세청 연동 해제 뒤 다시 등록해요.

발급 설정

대시보드 현금영수증 > 발급 설정에서 정해요. 설정은 소유자와 개발자가 바꿀 수 있어요.

자동 발급

주문을 만들 때 cashReceipt에 구매자가 요청한 현금영수증 정보를 넣어요.

{
  "customer": { "name": "홍길동", "email": "hong@example.com" },
  "amount": 50000,
  "cashReceipt": { "type": "PERSONAL", "identifier": "01012345678" }
}

하이픈과 공백은 빼고 검사해요. 형식이 틀리면 220007로 실패해요. 결제 대기 주문은 주문 수정으로 바꾸거나 null로 지울 수 있어요.

주문이 결제 완료되면 페이싱크가 결제된 금액(paidAmount)으로 현금영수증을 발급해요. 자동 매칭, 대시보드 직접 매칭, 결제 완료 처리 모두 해당해요.

자진발급

구매자가 현금영수증을 요청하지 않았어도 판매자는 국세청 지정 번호 010-000-1234로 자진발급할 수 있어요. 요청 없는 주문은 자진발급을 켜면 cashReceipt가 없는 주문 중 기준 금액 이상인 주문에 자동으로 자진발급해요. 직접 발급할 때는 selfIssued를 true로 보내요. 자진발급은 PERSONAL만 돼요.

직접 발급

대시보드 현금영수증에서 발급하거나 현금영수증 발급 API를 호출해요. API는 읽기·쓰기 권한의 키로 호출해요. 대시보드에서는 소유자와 멤버가 발급해요.

• invoiceId를 넣으면 그 주문과 연결해요. 구매자 이름과 주문번호를 주문에서 가져오고, 구매자에게 발급 알림 메일을 보내요. 주문에 이미 발급 중이거나 발급된 현금영수증이 있으면 240012로 실패하고 data.cashReceiptId에 그 현금영수증 ID가 와요.
• invoiceId 없이 발급하면 금액을 자유롭게 정할 수 있고, 메일은 보내지 않아요.
• API는 주문의 상태나 금액을 검사하지 않아요. 결제 완료된 주문의 결제 금액으로 발급하세요.

발급 결과

현금영수증은 발급을 요청하면 바로 승인번호가 생기고, 국세청에는 다음 날 0시에 전송해요. 국세청 결과는 다음 날 오전 10시 이후에 반영돼요.

발급 API는 거절당해도 200으로 응답하고 status가 FAILED인 현금영수증을 돌려줘요. 응답의 status를 꼭 확인하세요. 현금영수증 웹훅은 없어서, 국세청 결과는 현금영수증 단건 조회로 확인해요.

재발급

발급에 실패한 원본은 failure의 안내를 보고 식별번호나 종류를 고쳐 재발급할 수 있어요. 원본 하나에 한 번만 재발급할 수 있고, 금액, 구매자 이름, 연결된 주문은 원본을 그대로 써요. 실패는 자동으로 다시 시도하지 않아요.

취소

국세청에 발급된(ISSUED) 원본만 취소할 수 있어요. 금액을 넣으면 그만큼만 부분 취소하고, 빼면 남은 금액을 모두 취소해요. 취소하면 취소 영수증이 따로 만들어져요. 국세청 전송을 기다리는 현금영수증은 다음 날 오전 10시 이후에 취소하세요.

주문을 취소하거나 매칭을 해제해도 현금영수증은 그대로예요. 환불했다면 현금영수증도 직접 취소하세요.

구매자에게 보내기

발급에 실패한 현금영수증은 보낼 수 없어요.