정산

정산 건별 목록 조회

get

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

사용처

• 판매자의 일별/건별 정산 내역을 조회할 수 있습니다

• 주문별 수수료, 할인, 실제 지급액 등의 상세 정보를 확인할 수 있습니다

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

dateConditionstring · enumRequired

정산 조회 기준

Example: PAYOUT_DATEPossible values:

nextTokenstringOptional

다음 페이지를 위한 커서 정보 (직전 호출에서 받은 nextToken을 그대로 넘겨 호출)

Example: eyJpZCI6MTAwMX0=

fromDatestring · dateRequired

조회 시작일자 yyyy-MM-dd 형태

Example: 2025-10-06

toDatestring · dateRequired

조회 종료일자 yyyy-MM-dd 형태 (fromDate와 31일 이상 차이날 수 없습니다)

Example: 2025-11-05

sizeinteger · int32Required

페이지 사이즈 (1 ~ 100)

Example: 100

partnerNamestringOptional

연동 프로그램명 또는 자사 서비스명

Example: 토스쇼핑

Responses

200

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

application/json

resultTypestring · enumOptional

응답 결과 타입

Possible values:

get

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

HTTPcURLJavaScriptPython

GET /api/v3/shopping-fep/settlement-steps?dateCondition=PAYOUT_DATE&fromDate=2026-02-24&toDate=2026-02-24&size=1 HTTP/1.1
Host: shopping-fep.toss.im
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

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

{
  "resultType": "SUCCESS",
  "error": {
    "errorCode": "INVALID_REQUEST",
    "reason": "text"
  },
  "success": {
    "items": [
      {
        "orderId": 10001,
        "orderProductId": 12345,
        "merchantId": 10001,
        "transactionTs": "2025-10-06T14:30:00",
        "originTransactionTs": "2025-10-05T10:20:00",
        "confirmedAt": "2025-10-13T09:00:00",
        "payoutDate": "2025-10-20",
        "diffSettlementPayoutDate": "2025-10-25",
        "productId": 50001,
        "stockId": 333444,
        "displayProductName": "리클라이너",
        "stockPrice": 50000,
        "orderProductStatus": "CONFIRMED_ORDER",
        "stepType": "PAY",
        "quantity": 2,
        "orderProductPrice": 100000,
        "orderProductPaidAmount": 95000,
        "payFeeRate": "2.5",
        "productFeeRate": "5.0",
        "payFee": 2375,
        "payVat": 238,
        "productFee": 4750,
        "productVat": 475,
        "feeBaseAmount": 7800,
        "tossPayDiscount": 3000,
        "tossPayPoint": 2000,
        "settlementAmount": 87162,
        "shoppingDiscount": 5000,
        "deliveryFeeAmount": 3000,
        "shoppingDiscountToss": 2000,
        "shoppingDiscountMerchant": 3000,
        "payoutBaseDate": "2025-10-13"
      }
    ],
    "nextToken": "eyJpZCI6MTAwMX0="
  }
}

정산 응답값 샘플

{
  "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 연동 중 문의사항이나 개선 제안이 있으신가요?

토스쇼핑 API 연동에 대한 질문이나, 건의사항이 있다면 연동/개발 문의에 남겨주세요. 다른 유저의 문의를 참고하거나, 토스쇼핑 담당자와 질의를 주고 받을 수 있어요.