---
title: "현금영수증 단건발급 API"
method: POST
path: "/receipts/{imp_uid}"
tags: ["receipts"]
---

# 현금영수증 단건발급 API

`POST /receipts/{imp_uid}`

포트원을 통해 발생된 현금성 거래<b>(가상계좌, 계좌이체)</b>의 포트원 거래고유번호(imp_uid)를 기준으로 현금영수증이 발급 됩니다.<br>
     imp_uid 거래를 처리하는데 사용된 PG설정값을 그대로 활용합니다.<br>
     (ex. KCP 거래건이면 KCP를 통해 현금영수증 발행 API처리)<br>
     현금영수증 발급 금액은 현금성 거래의 금액으로 자동 적용됩니다. 부분취소된 거래인 경우 남은 잔액으로 발급됩니다.<br><br>
     <h4>지원되는 PG사</h4>
     <ul> <li>KG 이니시스</li> <li>NHN KCP</li> <li>나이스페이먼츠</li> <li>KICC</li>
     <li>헥토파이낸셜(구 세틀뱅크)</li> <li>키움페이(구 다우, 페이조아)</li>
     <li>토스페이먼츠 - 신모듈</li> <li>KSNET</li> <li>스마트로 - 신모듈</li><li>(신) 나이스페이</li><li>웰컴페이먼츠</li></ul>

## Path parameters

- `imp_uid` string, required

## Response `200`

현금영수증 발행 완료

- ReceiptResponse — 현금영수증 발행 상세정보. 바로 아래 Receipt structure를 확인하세요
  - `code` integer — 0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다
  - `message` string — code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
  - `response` ReceiptAnnotation
    - `imp_uid` string, required — 포트원 거래고유번호
    - `receipt_tid` string — 현금영수증 PG사 발행고유번호
    - `apply_num` string, required — 현금영수증 국세청 발행번호
    - `type` string, required — 현금영수증 발행대상 타입 <ul><li>개인 : `person` </li><li>사업자 : `company`</li></ul>
    - `amount` integer, required — 현금영수증 발행금액
    - `vat` integer, required — 현금영수증 발행금액 중 부가세금액
    - `receipt_url` string — 발행된 현금영수증 URL
    - `applied_at` integer, required — 현금영수증 발행시각 UNIX TIMESTAMP
    - `cancelled_at` integer — 현금영수증 발행취소시각 UNIX TIMESTAMP

## Other responses

- `400` — 필수 파라메터가 누락된 경우, 결제완료(paid)가 아닌 결제 건에 대해 발행요청한 경우, 이미 현금영수증 발행된 건에 대해 요청한 경우
- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `500` — 현금영수증 발행에 실패한 경우
- `501` — 현재 포트원이 현금영수증 관련 지원하지 않는 PG사인 경우

---

[API](https://skmtc.net/iamport/apis/rest-api.md) · [All operations](https://skmtc.net/iamport/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/iamport/rest-api/versions/006dfffdec43/schema)