연결 구매자 API
판매자와 연결된 구매자 목록을 조회하는 API입니다.
엔드포인트
구분설명
GET /buyers
연결 구매자 목록 (buyers:read)
목록 조회
현재 판매자와 관계가 있는 구매자(승인·대기·거절)를 반환합니다.
식별자는 business_number(사업자번호)입니다. 내부 UUID는 응답에 포함되지 않습니다.
bash
curl "https://qnector.kr/api/v1/seller/buyers" \ -H "Authorization: Bearer qnc_live_YOUR_API_KEY"
엔드포인트 예시
GET /buyers
연결 구매자 목록 (buyers:read)
응답 예시 (200)
json
{
"data": [
{
"business_number": "123-45-67890",
"name": "테스트 구매자",
"ceo_name": "김구매",
"status": "approved",
"approved_at": "2026-06-01T09:00:00Z",
"created_at": "2026-05-20T10:00:00Z",
"phone": "010-1234-5678",
"email": "buyer@example.com",
"tier_code": "A",
"tier_name": "A등급",
"payment_enabled": true,
"order_option_enabled": true,
"price_display_basis": "vat_included",
"hide_prices": false,
"is_sandbox_account": false
}
],
"meta": {},
"errors": []
}응답 필드
| 필드 | 필수여부 | 자릿수/형식 | 설명 |
|---|---|---|---|
| business_number | - | string | 구매자 사업자번호(공개 식별자) |
| name | - | string | 상호(회사명) |
| ceo_name | - | string | 대표자명 |
| status | - | string | 연결 상태. approved | pending | rejected |
| approved_at | - | string | null (ISO 8601) | 승인 시각 |
| created_at | - | string (ISO 8601) | 관계 생성 시각 |
| phone | - | string | 연락처 |
| - | string | 계정 이메일 | |
| tier_code | - | string | null | 구매자 등급 코드 |
| tier_name | - | string | null | 구매자 등급명 |
| payment_enabled | - | boolean | 해당 구매자 결제 기능 사용 여부 |
| order_option_enabled | - | boolean | 주문 옵션 사용 여부 |
| price_display_basis | - | vat_included | vat_excluded | 단가 표시 기준 |
| hide_prices | - | boolean | 단가 숨김 여부 |
| is_sandbox_account | - | boolean | 테스트(샌드박스) 계정 여부 |
연결 상태
구분설명
approved
승인됨 — 거래 가능
pending
승인 대기
rejected
거절됨
제한 사항
- 쓰기(승인·거절·등급 변경 등)는 제공하지 않습니다. 조회(buyers:read)만 지원합니다.
- 어드민·본인(판매자) 계정은 목록에서 제외됩니다.
- 유료 플랜(api_access)과 buyers:read 스코프가 필요합니다.