# 현금영수증 단건발급 API

{% hint style="warning" %}
**Deprecated**

이 문서는 더 이상 관리되지 않습니다.

[PortOne 개발자센터](https://developers.portone.io/)를 이용해주세요.
{% endhint %}

### 현금영수증을 발급할 수 있습니다.

포트원을 통해 발생된 현금성 거래(**가상계좌,게좌이체**)의 포트원 거래번호(<mark style="color:red;">**`imp_uid`**</mark>)를 기준으로 현금영수증이 발급 됩니다. 현금영수증 발급 금액은 **현금성 거래의 금액으로 자동 적용**됩니다. 부분취소된 거래인 경우 **남은 잔액으로 발급**됩니다.

<details>

<summary><strong>지원되는 PG사</strong> 확인하기</summary>

* **KG 이니시스**
* **NHN KCP**
* **Settle Bank**
* **NICE Payments**
* **PayJoa(다우)**
* **KICC**
* **헥토파이낸셜**
* **케이에스넷**
* **스마트로 - 신모듈**
* **토스페이먼츠 - 신모듈**

</details>

## 현금거래에 대한 현금영수증을 발급합니다.

<mark style="color:green;">`POST`</mark> `https://api.iamport.kr/receipts/{imp_uid}`

현금영수증 발행을 처리하는 포트원 API 입니다.

#### Path Parameters

| Name                                       | Type   | Description                                  |
| ------------------------------------------ | ------ | -------------------------------------------- |
| imp\_uid<mark style="color:red;">\*</mark> | String | <mark style="color:red;">**포트원 거래번호**</mark> |

#### Request Body

| Name                                            | Type    | Description                                                                                                                                                                               |
| ----------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| product\_type<mark style="color:red;">\*</mark> | String  | <mark style="color:red;">**현금영수증 발행대상 식별정보**</mark>                                                                                                                                       |
| identifier<mark style="color:red;">\*</mark>    | String  | <mark style="color:red;">**현금영수증 발행대상 식별정보**</mark>                                                                                                                                       |
| identifier\_type                                | String  | <p><strong>현금영수증 식별정보 구분코드</strong></p><p><code>person : 주민등록번호</code></p><p><code>business : 사업자등록번호</code></p><p><code>phone : 휴대폰번호</code></p><p><code>taxcard : 국세청현금영수증카드</code></p> |
| type                                            | String  | <p><strong>현금영수증 발행 구분코드</strong></p><p><code>소득공제용(개인) : person</code></p><p><code>지출증빙용(법인) : company</code></p><p><code>기본값 : person</code></p>                                        |
| company\_tel                                    | String  | <p><strong>발행 상점 고객센터 번호</strong></p><p>(페이조아인 경우만 필수)</p>                                                                                                                                |
| company\_name                                   | String  | <p><strong>상점 사업자 명</strong></p><p>(페이조아인 경우만 필수)</p>                                                                                                                                     |
| corp\_reg\_no                                   | String  | <p><strong>상점 사업자 번호</strong></p><p>(페이조아인 경우만 필수)</p>                                                                                                                                    |
| buyer\_name                                     | String  | **구매자 이름**                                                                                                                                                                                |
| buyer\_email                                    | String  | **구매자 Email 주**                                                                                                                                                                           |
| buyer\_tel                                      | String  | **구매자 전화번호**                                                                                                                                                                              |
| tax\_free                                       | integer | **면세금액**                                                                                                                                                                                  |

{% tabs %}
{% tab title="200: OK 성공" %}
{% tabs %}
{% tab title="ReceiptResponse" %}
**`code`** <mark style="color:red;">**\***</mark> <mark style="color:purple;">**integer**</mark>

**응답코드**

0이면 정상적인 조회, 0 이 아닌 값이면 message를 확인해봐야 합니다

**`message`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**string**</mark>

**응답메세지**

code 값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다

**`response`** <mark style="color:red;">**`(ReceiptAnnotation, optional)`**</mark>
{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="ReceiptAnnotation" %}
**`imp_uid`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**`string`**</mark>

**`포트원 거래번호`**

**`receipt_tid`** <mark style="color:green;">**`string`**</mark>

**`현금영수증 PG사 발행고유번호`**

**`apply_num`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**`string`**</mark>

**`현금영수증 국세청 발행번호`**

**`type`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**`string`**</mark>

**`현금영수증 발행대상 타입`**

* 개인 : `person`
* 사업자 : `company`

**`amount`** <mark style="color:red;">**\***</mark> <mark style="color:orange;">**`integer`**</mark>

**`현금영수증 발행금액`**

**`vat`** <mark style="color:red;">**\***</mark> <mark style="color:orange;">**`integer`**</mark>

**`부가세`**

**`receipt_url`** <mark style="color:green;">**`string`**</mark>

**`발행된 현금영수증 URL`**

**`applied_at`** <mark style="color:red;">**\***</mark> <mark style="color:orange;">**`integer`**</mark>

**현금영수증 발행시각** `UNIX TIMESTAMP`

**`cancelled_at`** <mark style="color:orange;">**`integer`**</mark>

**`현금영수증 발행취소시각`** `UNIX TIMESTAMP`
{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="400: Bad Request 필수 파라미터가 누락된 경우, 결제완료(paid)가 아닌 결제 건에 대해 발행요청한 경우, 이미 현금영수증 발행된 건에 대해 요청한 경우" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="401: Unauthorized 인증 Token이 전달되지 않았거나 유효하지 않은 경우" %}

```javascript
{
    // Response
}
```

{% endtab %}

{% tab title="500: Internal Server Error 현금영수증 발행에 실패한 경우" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

### **주요 요청 파라미터 상세 설명**

> **`identifier`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**`string`**</mark>
>
> **`현금영수증 식별정보 구분코드`**
>
> 국세청현금영수증카드, 휴대폰번호, 주민등록번호, 사업자등록번호 를 기재합니다.

> **`identifier_type`** <mark style="color:red;">**\***</mark> <mark style="color:green;">**`string`**</mark>
>
> **`현금영수증 식별정보 구분코드`**
>
> **KICC, 세틀뱅크**인 경우에만 <mark style="color:red;">**필수**</mark>
>
> KG이니시스/NHN KCP/나이스페이먼츠/페이조아는 **identifier 만으로 자동 처리**

<details>

<summary>Response Model Schema</summary>

```json
{
  "code": 0,
  "message": "string",
  "response": {
    "imp_uid": "string",
    "receipt_tid": "string",
    "apply_num": "string",
    "type": "person",
    "amount": 0,
    "vat": 0,
    "receipt_url": "string",
    "applied_at": 0,
    "cancelled_at": 0
 }
}
```

</details>

{% hint style="success" %}
**Swagger Test Link**

[**https://api.iamport.kr/#!/receipts/issueReceipt**](https://api.iamport.kr/#!/receipts/issueReceipt)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://portone.gitbook.io/docs/api/api-8/api-2.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.