# 정산 ## 정산 건별 목록 조회 > 가맹점의 정산 내역을 건별로 조회합니다.\ > \ > \## 사용처\ > \- 판매자의 일별/건별 정산 내역을 조회할 수 있습니다\ > \- 주문별 수수료, 할인, 실제 지급액 등의 상세 정보를 확인할 수 있습니다 ```json {"openapi":"3.0.1","info":{"title":"ShoppingFep API","version":"snapshot"},"servers":[{"url":"https://shopping-fep.toss.im"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"GetSettlementListFepResponse":{"required":["items","nextToken"],"type":"object","properties":{"items":{"type":"array","description":"정산 내역 상세 목록","items":{"$ref":"#/components/schemas/GetSettlementFepResponse"}},"nextToken":{"type":"string","description":"다음 페이지를 위한 커서 정보"}},"description":"정산 내역 목록 조회 응답"},"GetSettlementFepResponse":{"required":["displayProductName","feeBaseAmount","merchantId","orderId","orderProductPaidAmount","orderProductPrice","orderProductStatus","payFee","payFeeRate","payVat","productFee","productFeeRate","productVat","quantity","settlementAmount","shoppingDiscount","stepType","stockPrice","tossPayDiscount","tossPayPoint","transactionTs"],"type":"object","properties":{"orderId":{"type":"integer","description":"주문을 식별하는 유니크한 값","format":"int64"},"orderProductId":{"type":"integer","description":"각 주문의 유니크한 상품 식별용 ID (배송비인 경우 null)","format":"int64"},"merchantId":{"type":"integer","description":"상점 식별용 ID","format":"int64"},"transactionTs":{"type":"string","description":"결제 일시"},"originTransactionTs":{"type":"string","description":"원거래 결제 일시 (환불/보정 건의 경우 원본 결제 일시)"},"confirmedAt":{"type":"string","description":"구매 확정일"},"payoutDate":{"type":"string","description":"지급일"},"diffSettlementPayoutDate":{"type":"string","description":"차액정산 지급일"},"productId":{"type":"integer","description":"상품 식별용 ID (배송비인 경우 null)","format":"int64"},"stockId":{"type":"integer","description":"옵션 번호","format":"int64"},"displayProductName":{"type":"string","description":"사용자에게 노출되는 상품 이름"},"stockPrice":{"type":"integer","description":"판매가 (셀러가 등록한 가격)","format":"int64"},"orderProductStatus":{"type":"string","description":"정산 주문 상품 상태 (배송비인 경우 빈 문자열로 반환됩니다)","enum":["CANCELED_PAYMENT","CONFIRMED_ORDER",""]},"stepType":{"type":"string","description":"정산 단계 유형","enum":["PAY","REFUND"]},"quantity":{"type":"integer","description":"주문 수량 (기본값: 1)","format":"int32"},"orderProductPrice":{"type":"integer","description":"정산 기준 금액","format":"int64"},"orderProductPaidAmount":{"type":"integer","description":"유저 실제 결제 금액. stepType.PAY 기준 orderProductPrice(정산기준금) - shoppingDiscount(프로모션 할인 금액) - tossPayDiscount(토스페이 할인) - tossPayPoint(토스페이 포인트 사용 금액)에 해당합니다.","format":"int64"},"payFeeRate":{"type":"string","description":"결제 수수료율 (소수점 형태)"},"productFeeRate":{"type":"string","description":"상품 수수료율 (소수점 형태)"},"payFee":{"type":"integer","description":"결제 수수료","format":"int64"},"payVat":{"type":"integer","description":"결제 수수료 부가세","format":"int64"},"productFee":{"type":"integer","description":"상품 수수료","format":"int64"},"productVat":{"type":"integer","description":"상품 수수료 부가세","format":"int64"},"feeBaseAmount":{"type":"integer","description":"수수료 기준 금액. (판매가 - 쿠폰 할인 부담금)에 해당하며, 2026년 1월 10일 이후 결제된 상품은 이 금액을 기준으로 결제 및 상품 판매 수수료가 계산됩니다.\n배송비의 경우 쿠폰 적용 여부와 관계없이 배송비 그대로 결제수수료가 계산됩니다.","format":"int64"},"tossPayDiscount":{"type":"integer","description":"토스페이 할인 금액","format":"int64"},"tossPayPoint":{"type":"integer","description":"토스페이 포인트 사용 금액","format":"int64"},"settlementAmount":{"type":"integer","description":"정산 지급액. 주문금액(주문상품의 '판매가' 및 배송비) - 결제수수료(payFee) - 결제수수료 부가세(payVat) - 상품 판매 수수료(productFee) - 상품 판매 수수료 부가세(productVat) - 셀러 부담 쿠폰 할인액(shoppingDiscountMerchant)에 해당합니다.\n유저가 토스페이 할인과 토스포인트 사용은 토스에서 비용을 부담하여 셀러에게 정산됩니다.","format":"int64"},"shoppingDiscount":{"type":"integer","description":"프로모션 할인. shoppingDiscountToss(토스 부담 할인) + shoppingDiscountMerchant(셀러 부담 쿠폰 할인)에 해당합니다.","format":"int64"},"deliveryFeeAmount":{"type":"integer","description":"배송비","format":"int64"},"shoppingDiscountToss":{"type":"integer","description":"토스 부담 할인 금액","format":"int64"},"shoppingDiscountMerchant":{"type":"integer","description":"셀러 부담 쿠폰 할인 금액","format":"int64"},"payoutBaseDate":{"type":"string","description":"구매확정일(정산기준일)","format":"date"}},"description":"정산 내역 상세"}}},"paths":{"/api/v3/shopping-fep/settlement-steps":{"get":{"tags":["정산"],"summary":"정산 건별 목록 조회","description":"가맹점의 정산 내역을 건별로 조회합니다.\n\n## 사용처\n- 판매자의 일별/건별 정산 내역을 조회할 수 있습니다\n- 주문별 수수료, 할인, 실제 지급액 등의 상세 정보를 확인할 수 있습니다","operationId":"getSettlementSteps","parameters":[{"name":"dateCondition","in":"query","description":"정산 조회 기준","required":true,"schema":{"type":"string","enum":["PAYOUT_DATE","PAYOUT_BASE_DATE","TRANSACTION_DATE","DIFF_SETTLEMENT_PAYOUT_DATE"]}},{"name":"nextToken","in":"query","description":"다음 페이지를 위한 커서 정보 (직전 호출에서 받은 nextToken을 그대로 넘겨 호출)","required":false,"schema":{"type":"string"}},{"name":"fromDate","in":"query","description":"조회 시작일자 yyyy-MM-dd 형태","required":true,"schema":{"type":"string","format":"date"}},{"name":"toDate","in":"query","description":"조회 종료일자 yyyy-MM-dd 형태 (fromDate와 31일 이상 차이날 수 없습니다)","required":true,"schema":{"type":"string","format":"date"}},{"name":"size","in":"query","description":"페이지 사이즈 (1 ~ 100)","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"partnerName","in":"query","description":"연동 프로그램명 또는 자사 서비스명","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)","content":{"application/json":{"schema":{"type":"object","properties":{"resultType":{"type":"string","description":"응답 결과 타입","enum":["SUCCESS","FAIL"]},"error":{"type":"object","properties":{"errorCode":{"type":"string","description":"에러 코드","enum":["INVALID_REQUEST","INVALID_DATE_RANGE","REQUEST_FAILED","INVALID_ARGUMENT","UNKNOWN"]},"reason":{"type":"string","description":"에러 사유"}},"description":"에러 응답, resultType FAIL 시 제공"},"success":{"$ref":"#/components/schemas/GetSettlementListFepResponse"}}}}}}}}}}} ``` ### 정산 응답값 샘플 ```json { "resultType": "SUCCESS", "success": { "items": [ // 구매확정 케이스 { "orderId": 300039, "orderProductId": 363559, "merchantId": 10027, "transactionTs": "2026-01-21 01:41:36", "originTransactionTs": "2026-01-21 01:41:36", "confirmedAt": "2026-01-21", "payoutDate": "2026-01-23", "diffSettlementPayoutDate": null, "productId": 138901, "stockId": 138901, "displayProductName": "테스트상품1", "stockPrice": 10800, "orderProductStatus": "CONFIRMED_ORDER", "stepType": "PAY", "quantity": 1, "orderProductPrice": 10800, "orderProductPaidAmount": 100, "payFeeRate": "0.03", "productFeeRate": "0.072", "payFee": -23, "payVat": -2, "productFee": -561, "productVat": -56, "feeBaseAmount": 7800, "tossPayDiscount": 0, "tossPayPoint": 7700, "settlementAmount": 7158, "shoppingDiscount": 3000, "deliveryFeeAmount": 0, "shoppingDiscountToss": 0, "shoppingDiscountMerchant": 3000, "payoutBaseDate": "2026-01-21" }, { "orderId": 300039, "orderProductId": null, "merchantId": 10027, "transactionTs": "2026-01-21 01:41:36", "originTransactionTs": null, "confirmedAt": "2026-01-21", "payoutDate": "2026-01-23", "diffSettlementPayoutDate": null, "productId": null, "stockId": null, "displayProductName": "배송비", "stockPrice": 0, "orderProductStatus": "", "stepType": "PAY", "quantity": 1, "orderProductPrice": 0, "orderProductPaidAmount": 0, "payFeeRate": "0.03", "productFeeRate": "0.0", "payFee": 0, "payVat": 0, "productFee": 0, "productVat": 0, "feeBaseAmount": 0, "tossPayDiscount": 0, "tossPayPoint": 0, "settlementAmount": 0, "shoppingDiscount": 0, "deliveryFeeAmount": 0, "shoppingDiscountToss": 0, "shoppingDiscountMerchant": 0, "payoutBaseDate": "2026-01-21" }, // 환불 케이스 { "orderId": 284349, "orderProductId": 343651, "merchantId": 10027, "transactionTs": "2025-10-22 17:34:03", "originTransactionTs": "2025-10-20 12:14:44", "confirmedAt": "2025-10-21", "payoutDate": "2025-10-24", "diffSettlementPayoutDate": null, "productId": 135165, "stockId": 135165, "displayProductName": "테스트상품2", "stockPrice": 20000, "orderProductStatus": "CANCELED_PAYMENT", "stepType": "REFUND", "quantity": 1, "orderProductPrice": 20000, "orderProductPaidAmount": -17520, "payFeeRate": "0.0", "productFeeRate": "0.09", "payFee": 60, "payVat": 6, "productFee": 1800, "productVat": 180, "feeBaseAmount": 0, "tossPayDiscount": -2480, "tossPayPoint": 0, "settlementAmount": -17954, "shoppingDiscount": 0, "deliveryFeeAmount": 0, "shoppingDiscountToss": 0, "shoppingDiscountMerchant": 0, "payoutBaseDate": "2025-10-22" }, { "orderId": 284349, "orderProductId": null, "merchantId": 10027, "transactionTs": "2025-10-22 17:34:03", "originTransactionTs": null, "confirmedAt": null, "payoutDate": "2025-10-24", "diffSettlementPayoutDate": null, "productId": null, "stockId": null, "displayProductName": "배송비", "stockPrice": 0, "orderProductStatus": "", "stepType": "REFUND", "quantity": 1, "orderProductPrice": 0, "orderProductPaidAmount": -4380, "payFeeRate": "0.0", "productFeeRate": "0.0", "payFee": 15, "payVat": 2, "productFee": 0, "productVat": 0, "feeBaseAmount": 0, "tossPayDiscount": -620, "tossPayPoint": 0, "settlementAmount": -4983, "shoppingDiscount": 0, "deliveryFeeAmount": -5000, "shoppingDiscountToss": 0, "shoppingDiscountMerchant": 0, "payoutBaseDate": "2025-10-22" } ], "nextToken": "eyJzdGVwTm9DdXJzb3JFeGNsdXNpdmUiOjgzMzU5NzI1LCJkYXRlQ29uZGl0aW9uIjoiUEFZT1VUX0JBU0VfREFURSJ9" } } ``` > ### API 연동 중 문의사항이나 개선 제안이 있으신가요? {% hint style="info" %} 토스쇼핑 API 연동에 대한 질문이나, 건의사항이 있다면 [연동/개발 문의](https://discord.gg/xPz6H9NZ3P)에 남겨주세요. 다른 유저의 문의를 참고하거나, 토스쇼핑 담당자와 질의를 주고 받을 수 있어요. {% endhint %}