# 취소 처리하기

취소는 **주문 배송이 시작하기 전에 주문을 무효화하는 것**입니다. 구매자, 판매자 둘 다 취소를 요청할 수 있어요.

1. [구매자의 취소 요청 처리하기](#undefined)
2. [직접 주문 취소하기](#undefined-7)

## 구매자의 취소 요청

<figure><img src="https://1893239884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5jZ0MNZGU289cgosea36%2Fuploads%2FRNlmuWyAte0KrIeYPAu9%2Fimage.png?alt=media&#x26;token=f9be2815-8f6c-4902-a51e-d199e19d1e0c" alt=""><figcaption></figcaption></figure>

구매자는 주문 상품이 '결제완료', '상품준비중', '발송지연' 상태일 때 토스앱에서 취소를 요청할 수 있어요.

'결제완료' 상태에서 구매자가 취소를 요청하면 주문 상태는 즉시 '결제취소'로 변경되고 구매자는 주문금액을 환불받습니다. 판매자는 별도로 **API를 호출하지 않아도 돼요. 이 경우는 클레임으로 잡히지 않습니다.**

'발송지연' 또는 '상품준비중' 상태에서 구매자가 취소를 요청하면 토스쇼핑 API로 **승인 또는 거절을** 할 수 있어요. 승인하면 환불과 함께 결제 취소 상태가 되고, 거절하면 주문이 바로 배송중 상태로 바뀌어요.

### 구매자의 취소 요청 승인 및 거절하기

'발송지연' 또는 '상품준비중' 상태에서 구매자가 요청한 취소를 승인 및 거절하는 방법을 알아볼게요.

{% stepper %}
{% step %}

### 취소 요청 확인하기

[클레임 목록 조회 API](https://shopping-docs.toss.im/dev/api-2/claim#get-api-v3-shopping-fep-claims)로 취소 요청을 확인해주세요.  `type` 쿼리 파라미터를 `CANCEL`로 설정해주세요. `status` 쿼리 파라미터는 항상 `REQUESTED`로 설정해주세요. '요청' 상태인 취소 클레임을 불러옵니다.

**GET** `/api/v3/shopping-fep/claims?type={claimType}&status={claimStatus}'`

```bash
  curl --request GET \
  --url 'https://shopping-fep.toss.im/api/v3/shopping-fep/claims?type=CANCEL&status=REQUESTED' \
  --header 'Authorization: Bearer {ACCESS_TOKEN}' \
  --header 'Content-Type: application/json'
```

{% endstep %}

{% step %}

### 클레임 ID로 취소 요청 승인/거절하기

응답의 `success` 필드 안에 `items.id`는 해당 클레임 요청의 유니크한 ID 값입니다. [취소 요청 승인](https://shopping-docs.toss.im/dev/api-2/claim#post-api-v3-shopping-fep-claims-claimid-cancel-approval)과 [취소 요청 거절](https://shopping-docs.toss.im/dev/api-2/claim#post-api-v3-shopping-fep-claims-claimid-cancel-rejection) API의 쿼리 파라미터로 사용해주세요.

* 취소 요청을 **승인**하려면 클레임 ID Path 파라미터만 채워서 API를 호출해주세요.\
  **POST** `/api/v3/shopping-fep/claims/{claimId}/cancel/approval`
* 취소 요청을 **거절**하려면 클레임 ID Path 파라미터와 택배사 및 송장번호 요청 파라미터를 추가해서 API를 호출해주세요.\
  **POST** `/api/v3/shopping-fep/claims/{claimId}/cancel/rejection`

{% tabs %}
{% tab title="취소 승인 예시" %}

```bash
  curl --request POST \
  --url 'https://shopping-fep.toss.im/api/v3/shopping-fep/claims/145523/cancel/approval
  --header 'Authorization: Bearer {ACCESS_TOKEN}' \
  --header 'Content-Type: application/json'
```

{% endtab %}

{% tab title="취소 거절 예시" %}

```bash
  curl --request POST \
  --url 'https://shopping-fep.toss.im/api-internal/v1/orders/claims/145523/cancel/rejection
  --header 'Authorization: Bearer {ACCESS_TOKEN}' \
  --header 'Content-Type: application/json'
  --data '{"deliveryCompany":"CJ대한통운", "shippingTrackingNumber":"1022-5765-4265"}
```

{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### 결제 취소 완료하기

요청이 성공적이면 HTTP 200과 아래 응답이 돌아옵니다.

```json
{
  "resultType":"SUCCESS",
  "success": {}
}
```

**취소를 승인했을 때**

* 클레임 상태가 `APPROVED`로 변경됩니다.
* 구매자에게 자동으로 주문금액이 환불됩니다.
* 주문상품 상태가 `결제취소`로 변경됩니다.

**취소를 거절했을 때**

* 클레임 상태가 `REJECTED`로 변경됩니다.
* 주문상품 상태가 `배송중`으로 변경됩니다.
* 배송정보(배송회사, 송장번호)가 등록됩니다.
  {% endstep %}
  {% endstepper %}

## 직접 주문 취소하기

판매자가 직접 주문을 취소할 수도 있어요. 판매자는 결제완료, 상품준비중, 발송지연, 배송중, 배송완료 상태의 주문을 취소할 수 있습니다.

* 판매자가 요청한 취소의  주문 상태는 즉시 '결제취소'로 바뀌어요
* 클레임 진행 중인 주문도 취소가 가능하며, 취소 후 마찬가지로 '결제취소' 상태로 바뀝니다.
* 이 경우 클레임으로 잡히지 않습니다.

{% stepper %}
{% step %}

### 주문내역 조회하기

[주문 내역 조회 API](https://shopping-docs.toss.im/dev/api-2/order#get-api-v3-shopping-fep-orders-v2)로 취소하고 싶은 주문의 ID(`orderProductId`)를 확인해주세요.

**GET** `/api/v3/shopping-fep/orders/v2?startDate={yyyy-MM-dd}&endDate={yyyy-MM-dd}'`&#x20;

```bash
  curl --request GET \
  --url 'https://shopping-fep.toss.im/api/v3/shopping-fep/orders/v2?startDate={yyyy-MM-dd}&endDate={yyyy-MM-dd}' \
  --header 'Authorization: Bearer {ACCESS_TOKEN}' \
  --header 'Content-Type: application/json'
```

{% endstep %}

{% step %}

### 주문 ID로 취소하기

응답의 `success` 필드 안에 `results.orderProductId`를 [판매자 주문 취소 API](https://shopping-docs.toss.im/dev/api-2/claim#post-api-v3-shopping-fep-order-products-orderproductid-seller-cancel)의 Path 파라미터로 사용해주세요. 요청 파라미터에는 배송비 부담하는 책임자와 취소 사유를 입력해주세요.

**POST** `/api/v3/shopping-fep/order-products/{orderProductId}/seller-cancel`

```bash
  curl --request POST \
  --url 'https://shopping-fep.toss.im/api/v3/shopping-fep/order-products/{orderProductId}/seller-cancel' \
  --header 'Authorization: Bearer {ACCESS_TOKEN}' \
  --header 'Content-Type: application/json'
  --body {"deliveryPenaltyCharger":"USER", "reason":"주문 취소 사유"}
```

{% endstep %}

{% step %}

### 취소 완료하기

요청이 성공적이면 HTTP 200과 아래 응답이 돌아옵니다.

```json
{
  "resultType":"SUCCESS",
  "success": {}
}
```

* 주문금액이 구매자에게 자동으로 환불됩니다.
* 주문상품 상태가 '결제취소'로 변경됩니다.
  {% endstep %}
  {% endstepper %}

> ### API 연동 중 문의사항이나 개선 제안이 있으신가요?

{% hint style="info" %}
토스쇼핑 API 연동에 대한 질문이나, 건의사항이 있다면 [연동/개발 문의](https://discord.gg/xPz6H9NZ3P)에 남겨주세요. 다른 유저의 문의를 참고하거나, 토스쇼핑 담당자와 질의를 주고 받을 수 있어요.
{% endhint %}