---
title: "정산 건별 목록 조회"
method: GET
path: "/api/v3/shopping-fep/settlement-steps"
tags: ["정산"]
---

# 정산 건별 목록 조회

`GET /api/v3/shopping-fep/settlement-steps`

가맹점의 정산 내역을 건별로 조회합니다.

## 사용처
- 판매자의 일별/건별 정산 내역을 조회할 수 있습니다
- 주문별 수수료, 할인, 실제 지급액 등의 상세 정보를 확인할 수 있습니다

## Query parameters

- `dateCondition` 'PAYOUT_DATE' | 'PAYOUT_BASE_DATE' | 'TRANSACTION_DATE' | 'DIFF_SETTLEMENT_PAYOUT_DATE', required
- `nextToken` string
- `fromDate` string, date, required
- `toDate` string, date, required
- `size` integer, required
- `partnerName` string

## Response `200`

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

- object
  - `resultType` 'SUCCESS' | 'FAIL' — 응답 결과 타입
  - `error` object — 에러 응답, resultType FAIL 시 제공
    - `errorCode` 'INVALID_REQUEST' | 'INVALID_DATE_RANGE' | 'REQUEST_FAILED' | 'INVALID_ARGUMENT' | 'UNKNOWN' — 에러 코드
    - `reason` string — 에러 사유
  - `success` GetSettlementListFepResponse — 정산 내역 목록 조회 응답
    - `items` GetSettlementFepResponse[], required — 정산 내역 상세 목록
      - `orderId` integer, required — 주문을 식별하는 유니크한 값
      - `orderProductId` integer — 각 주문의 유니크한 상품 식별용 ID (배송비인 경우 null)
      - `merchantId` integer, required — 상점 식별용 ID
      - `transactionTs` string, required — 결제 일시
      - `originTransactionTs` string — 원거래 결제 일시 (환불/보정 건의 경우 원본 결제 일시)
      - `confirmedAt` string — 구매 확정일
      - `payoutDate` string — 지급일
      - `diffSettlementPayoutDate` string — 차액정산 지급일
      - `productId` integer — 상품 식별용 ID (배송비인 경우 null)
      - `stockId` integer — 옵션 번호
      - `displayProductName` string, required — 사용자에게 노출되는 상품 이름
      - `stockPrice` integer, required — 판매가 (셀러가 등록한 가격)
      - `orderProductStatus` 'CANCELED_PAYMENT' | 'CONFIRMED_ORDER' | '', required — 정산 주문 상품 상태 (배송비인 경우 빈 문자열로 반환됩니다)
      - `stepType` 'PAY' | 'REFUND', required — 정산 단계 유형
      - `quantity` integer, required — 주문 수량 (기본값: 1)
      - `orderProductPrice` integer, required — 정산 기준 금액
      - `orderProductPaidAmount` integer, required — 유저 실제 결제 금액. stepType.PAY 기준 orderProductPrice(정산기준금) - shoppingDiscount(프로모션 할인 금액) - tossPayDiscount(토스페이 할인) - tossPayPoint(토스페이 포인트 사용 금액)에 해당합니다.
      - `payFeeRate` string, required — 결제 수수료율 (소수점 형태)
      - `productFeeRate` string, required — 상품 수수료율 (소수점 형태)
      - `payFee` integer, required — 결제 수수료
      - `payVat` integer, required — 결제 수수료 부가세
      - `productFee` integer, required — 상품 수수료
      - `productVat` integer, required — 상품 수수료 부가세
      - `feeBaseAmount` integer, required — 수수료 기준 금액. (판매가 - 쿠폰 할인 부담금)에 해당하며, 2026년 1월 10일 이후 결제된 상품은 이 금액을 기준으로 결제 및 상품 판매 수수료가 계산됩니다. 배송비의 경우 쿠폰 적용 여부와 관계없이 배송비 그대로 결제수수료가 계산됩니다.
      - `tossPayDiscount` integer, required — 토스페이 할인 금액
      - `tossPayPoint` integer, required — 토스페이 포인트 사용 금액
      - `settlementAmount` integer, required — 정산 지급액. 주문금액(주문상품의 '판매가' 및 배송비) - 결제수수료(payFee) - 결제수수료 부가세(payVat) - 상품 판매 수수료(productFee) - 상품 판매 수수료 부가세(productVat) - 셀러 부담 쿠폰 할인액(shoppingDiscountMerchant)에 해당합니다. 유저가 토스페이 할인과 토스포인트 사용은 토스에서 비용을 부담하여 셀러에게 정산됩니다.
      - `shoppingDiscount` integer, required — 프로모션 할인. shoppingDiscountToss(토스 부담 할인) + shoppingDiscountMerchant(셀러 부담 쿠폰 할인)에 해당합니다.
      - `deliveryFeeAmount` integer — 배송비
      - `shoppingDiscountToss` integer — 토스 부담 할인 금액
      - `shoppingDiscountMerchant` integer — 셀러 부담 쿠폰 할인 금액
      - `payoutBaseDate` string, date — 구매확정일(정산기준일)
    - `nextToken` string, required — 다음 페이지를 위한 커서 정보

---

[API](https://skmtc.net/toss/apis/shoppingfep-api.md) · [All operations](https://skmtc.net/toss/apis/shoppingfep-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/toss/shoppingfep-api/revisions/57a25c0addc6/schema)