정산 (지원 종료 예정)
정산 목록 조회 (폐기 예정)
**폐기 예정(deprecated).** 플랫폼 수수료를 공제하는 정산 모델은 폐기됐다 — PG는 셀러가 직접 계약하고 대금도 PG에서 셀러에게 바로 정산된다. 새 정산 레코드는 더 이상 만들어지지 않으며, 이 API는 기존 레코드 조회만 유지한다. 대체 API는 `GET /v1/sales-report`(PG별 결제·환불 매출 리포트)다.
Deprecated
폐기 예정(deprecated). 플랫폼 수수료를 공제하는 정산 모델은 폐기됐다 — PG는 셀러가 직접 계약하고 대금도 PG에서 셀러에게 바로 정산된다. 새 정산 레코드는 더 이상 만들어지지 않으며, 이 API는 기존 레코드 조회만 유지한다. 대체 API는 GET /v1/sales-report(PG별 결제·환불 매출 리포트)다.
Authorization
bearer AuthorizationBearer <token>
userToken(계정 스코프) 또는 storeToken(스토어 스코프)
In: header
Query Parameters
from*string
정산일 조회 시작 (ISO 8601, 포함). 필수
to?string
정산일 조회 끝 (ISO 8601, 포함). 생략하면 from부터 31일. 기간은 최대 31일
status?string
정산 상태 필터
Value in
- "SCHEDULED"
- "PAID"
- "HELD"
page?string
페이지 번호 (1부터, 기본 1)
size?string
페이지 크기 (기본 20, 최대 100)
Response Body
application/json
curl -X GET "https://example.com/v1/settlements?from=string"{ "meta": { "status": 200, "code": "OK", "message": "OK", "isSuccess": true }, "data": { "page": 0, "size": 0, "totalElements": 0, "totalPages": 0, "contents": [ { "settlementId": "string", "settlementDate": "string", "payoutDate": "string", "status": "SCHEDULED", "totalPaymentAmount": 0, "totalCommission": 0, "totalDeliveryFee": 0, "adjustmentAmount": 0, "settlementAmount": 0, "itemCount": 0 } ] }, "error": null}