정산 API

판매자 정산 내역 목록 조회 API입니다. 정산 금액 등록은 제공하지 않습니다.

엔드포인트

구분설명

GET /settlements

정산 목록 (settlements:read)

목록 조회

식별 키는 order_number입니다. 결제 상태가 있거나 완료(completed)된 주문이 포함됩니다.

bash

curl "https://qnector.kr/api/v1/seller/settlements" \
  -H "Authorization: Bearer qnc_live_YOUR_API_KEY"

엔드포인트 예시

GET /settlements

정산 목록 (settlements:read)

응답 예시 (200)

json

{
  "data": [
    {
      "order_number": "ORD-20260626-001",
      "buyer_name": "테스트 구매자",
      "total_amount": 45000,
      "settled_amount": 45000,
      "remaining_amount": 0,
      "status": "completed",
      "settlement_due_date": "2026-07-05",
      "payment_status": "DONE",
      "created_at": "2026-06-26T10:00:00Z"
    }
  ],
  "meta": {},
  "errors": []
}