# 정산 ## 정산 건별 목록 조회 > 가맹점의 정산 내역을 건별로 조회합니다.\ > \ > \## 사용처\ > \- 판매자의 일별/건별 정산 내역을 조회할 수 있습니다\ > \- 주문별 수수료, 할인, 실제 지급액 등의 상세 정보를 확인할 수 있습니다 ```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 %} --- # 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://shopping-docs.toss.im/dev/api-2/settlement.md?ask= ``` 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.