---
title: "현금영수증 발급(외부) API"
method: POST
path: "/receipts/external/{merchant_uid}"
tags: ["receipts"]
---

# 현금영수증 발급(외부) API

`POST /receipts/external/{merchant_uid}`

포트원과 별개로 거래된 일반 현금결제에 대해, 포트원 내에 설정된 PG사로 현금영수증 발행 요청하는 API입니다.

     <h4>지원되는 PG사</h4>
     <ul> <li>KG이니시스
     </li> <li>NHN KCP
     </li> <li>나이스페이먼츠
     </li> <li>KICC
     </li> <li>헥토파이낸셜(구 세틀뱅크)
     </li> <li>토스페이먼츠 - 신모듈
     </li> <li>KSNET
     </li> <li>스마트로 - 신모듈
     </li><li>(신) 나이스페이
     </li><li>웰컴페이먼츠</li></ul>

## Path parameters

- `merchant_uid` string, required

## Response `200`

현금영수증 발행 완료

- ExternalReceiptResponse — 현금영수증 발행 상세정보. 바로 아래 Receipt structure를 확인하세요
  - `code` integer — 0이면 정상적인 조회, 0아닌 값이면 message를 확인해봐야 합니다
  - `message` string — code값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다
  - `response` ExternalReceiptAnnotation
    - `merchant_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` — 필수 파라메터가 누락된 경우, 이미 현금영수증 발행된 merchant_uid 에 대해 요청한 경우
- `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)