구매자 정산 API

정산 목록 조회 API입니다. 조회 전용입니다.

엔드포인트

구분설명

GET /settlements

정산 목록 (settlements:read)

목록 조회

쿼리: status, page, limit(1~100, 기본 20)

bash

curl "https://qnector.kr/api/v1/buyer/settlements?page=1&limit=20" \
  -H "Authorization: Bearer qnc_buyer_YOUR_API_KEY"

엔드포인트 예시

GET /settlements

정산 목록 (settlements:read)

응답 예시 (200)

json

{
  "data": [
    {
      "settlement_number": "SET-20260626-001",
      "seller_code": "123-45-67890",
      "status": "requested",
      "settlement_type": "manual",
      "requested_amount": 45000,
      "settled_amount": null,
      "created_at": "2026-06-26T11:00:00Z",
      "updated_at": null
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 1 },
  "errors": []
}

응답 필드

필드	필수여부	자릿수/형식	설명
settlement_number	-	string	정산 식별자(번호 또는 공개 ID)
seller_code	-	string	판매자 사업자번호
status	-	string	정산 상태
settlement_type	-	string \| null	weekly \| monthly \| manual 등
requested_amount	-	number \| null	요청 금액
settled_amount	-	number \| null	확정 금액
created_at / updated_at	-	string \| null	생성·수정 시각

제한 사항

정산 요청·상태 변경은 1차 범위에서 제공하지 않습니다.
settlements:read 스코프와 유료 api_access가 필요합니다.