정산

정산 건별 목록 조회

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

Responses

200

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

application/json

get

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

HTTPcURLJavaScriptPython

GET /api/v3/shopping-fep/settlement-steps?dateCondition=PAYOUT_DATE&fromDate=2025-12-11&toDate=2025-12-11&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": 123456789,
        "orderProductId": 987654321,
        "merchantId": 12345,
        "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": 111222,
        "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,
        "tossPayDiscount": 3000,
        "tossPayPoint": 2000,
        "settlementAmount": 87162,
        "shoppingDiscount": 5000,
        "deliveryFeeAmount": 3000,
        "shoppingDiscountToss": 2000,
        "shoppingDiscountMerchant": 3000,
        "payoutBaseDate": "2025-10-13"
      }
    ],
    "nextToken": "eyJpZCI6MTAwMX0="
  }
}

질문은 여기에 남겨주세요. 토스쇼핑 담당자가 확인하고 이메일로 답변드려요.