정산 (지원 종료 예정)
정산 목록 조회 (폐기 예정)
**폐기 예정(deprecated).** 플랫폼 수수료를 공제하는 정산 모델은 폐기됐다 — PG는 셀러가 직접 계약하고 대금도 PG에서 셀러에게 바로 정산된다. 새 정산 레코드는 더 이상 만들어지지 않으며, 이 API는 기존 레코드 조회만 유지한다. 대체 API는 `GET /v1/sales-report`(PG별 결제·환불 매출 리포트)다.
Deprecated
GET
폐기 예정(deprecated). 플랫폼 수수료를 공제하는 정산 모델은 폐기됐다 — PG는 셀러가 직접 계약하고 대금도 PG에서 셀러에게 바로 정산된다. 새 정산 레코드는 더 이상 만들어지지 않으며, 이 API는 기존 레코드 조회만 유지한다. 대체 API는 GET /v1/sales-report(PG별 결제·환불 매출 리포트)다.
accessTokenheader
AuthorizationBearer <token>Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)
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)
X-Store-Id*string대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다
성공
application/json- response
meta*data*error*|nullcurl -X GET 'https://api.sayren.io/v1/settlements?from=string' \ -H 'X-Store-Id: 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}