> For the complete documentation index, see [llms.txt](https://workspace-help.nhn-commerce.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://workspace-help.nhn-commerce.com/aurora-guide/api-1/mypage-benefit/coupon-list.md).

# 쿠폰

기본 스킨에서 쿠폰은 '사용가능 쿠폰', '사용불가 쿠폰'으로 나눠서 쿠폰 리스트를 제공합니다.

* 사용 가능 쿠폰
  * 발급 받은 쿠폰 중 사용기간이 남아 있는 쿠폰

<figure><img src="/files/pdOnv1pNWLnF3K3TCr40" alt=""><figcaption></figcaption></figure>

* 사용 불가 쿠폰
  * 발급 받은 쿠폰 중 사용이 불가한 쿠폰 (기간 만료 및 사용 완료)

<figure><img src="/files/Fr1BGeLkvY8d0npSOf2i" alt=""><figcaption></figcaption></figure>

#### ◼︎ 쿠폰 리스트

<figure><img src="/files/f6EUACEd2nuveHSwrRFz" alt=""><figcaption></figcaption></figure>

> [GET /coupons](https://docs.shopby.co.kr/?url.primaryName=promotion/#/Coupon/get-my-coupons)
>
> ▶ 내 쿠폰 가져오기\
> 회원의 사용가능 쿠폰과 사용불가 쿠폰을 구분하여 조회합니다.

API 호출 시 요청 파라미터 <mark style="background-color:yellow;">usable</mark> 의 값에 따라 사용 가능 쿠폰 혹은 사용 불가 쿠폰 정보를 조회 할 수 있습니다.

<mark style="background-color:yellow;">usable=true</mark> 인 경우에는 조회 시점 기준으로 사용 가능한 쿠폰의 정보를 확인 가능하며,\ <mark style="background-color:yellow;">usable=false</mark>인 경우에는 조회 시점 기준으로 사용 불가한 쿠폰의 정보를 확인할 수 있습니다.

기본 스킨의 경우 사용가능 쿠폰 리스트에서는 '만료일'을 출력하고, 사용불가 쿠폰리스트에서는 '사용일' 또는 '만료일'을 출력합니다.\
각 날짜 출력 구분은 아래의 내용으로 처리 하시면 됩니다.

{% code overflow="wrap" %}

```
사용가능 쿠폰리스트의 만료일은 used 가 true일때, useEndYmdt 값을 만료일로 출력 
사용불가 쿠폰리스트의 만료일은 used가 true일때, useEndYmdt 값을 만료일로 출력 
사용불가 쿠폰리스트의 만료일은 used가 false일때, expireYmdt 값을 만료일로 출력
```

{% endcode %}

#### ◼︎ 쿠폰 등록 하기

<figure><img src="/files/LiorQjbuN7208gao8xZc" alt=""><figcaption></figcaption></figure>

기본 스킨에서는 쿠폰 등록 버튼을 통해 쿠폰코드를 입력하여 쿠폰을 추가할 수 있는 기능을 제공합니다.\
쿠폰 등록 가능한 쿠폰 발급은 에서 발급 유형을 '코드발급'으로 등록한 쿠폰을 추가 할 수 있습니다.

아래 어드민 경로에서 쿠폰 등록이 가능합니다.

```
shop by basic/pro : 프로모션 > 쿠폰 관리
shop by premium : 프로모션 관리 > 할인쿠폰 관리 
```

쿠폰 코드는 쇼핑몰 운영자가 쿠폰 등록 시 입력한 프로모션 코드를 입력하면 쿠폰 추가가 가능합니다.

```
▶ 코드 쿠폰 발급하기
등록된 프로모션 코드를 입력하여 회원에게 쿠폰을 발급합니다.
```

> [POST /coupons/register-code/{promotionCode}](https://docs.shopby.co.kr/?url.primaryName=promotion/#/Coupon/post-register-code-download)
>
> ► 코드 쿠폰 발급하기\
> 등록된 프로모션 코드를 입력하여 회원에게 쿠폰을 발급합니다.