---
title: "외부 발급내역 단건 조회 API"
method: GET
path: "/receipts/external/{merchant_uid}"
tags: ["receipts"]
---

# 외부 발급내역 단건 조회 API

`GET /receipts/external/{merchant_uid}`

포트원 API를 통해 현금영수증만 발행된 건의 상세정보를 조회하는 API입니다. (포트원과 별개로 결제된 현금거래건)

## 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

- `401` — 인증 Token이 전달되지 않았거나 유효하지 않은 경우
- `404` — merchant_uid 로 현금영수증 발행된 내역이 확인되지 않는 경우

---

[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)