사양 확정 전 · 아래 내용은 설계 초안입니다

학원 시스템과 Aedu를 잇는 방법

이미 쓰는 학원 관리 프로그램이 있다면, 교재 주문과 결제·정산 데이터를 API로 주고받을 수 있도록 설계하고 있습니다. 아래는 연동을 검토하기 위한 구조 초안입니다.

무엇을 연동하나요

세 가지 방향으로 데이터를 주고받습니다

01 조회

출판사·학년·과목으로 교재를 검색하고 상세 정보를 가져옵니다.

02 생성

학원 시스템에서 만든 주문과 원비 청구를 Aedu로 넘깁니다.

03 수신

결제 완료와 배송 상태 변경을 웹훅으로 받습니다.

경로·필드명·응답 형식은 확정 전입니다. 연동 범위를 논의하기 위한 예시로 봐주세요.

GET /v1/books 교재 목록 조회 · 출판사/학년/과목 필터

GET /v1/books/{id} 교재 상세 · 구성 · 대상 학년

POST /v1/orders 교재 주문 생성

GET /v1/orders/{id} 주문 상태 조회

POST /v1/invoices 원비 청구 생성

GET /v1/settlements 기간별 정산 내역

POST /v1/token
Content-Type: application/json

{
  "client_id": "aedu_xxx",
  "client_secret": "••••••••"
}

발급된 토큰을 Authorization: Bearer 헤더에 담아 호출합니다. 토큰 수명과 갱신 정책은 확정 전입니다.

POST https://학원시스템/aedu/hook

{
  "event": "payment.completed",
  "invoice_id": "inv_0912",
  "occurred_at": "2026-08-01T09:12:00+09:00"
}

결제 완료, 주문 확정, 배송 상태 변경 시점에 이벤트를 보냅니다. 재시도 정책과 서명 검증 방식은 확정 전입니다.

어떤 데이터를 어느 방향으로 주고받을지 정합니다.

샌드박스 환경에서 먼저 붙여봅니다.

주문·결제 흐름이 실제 업무와 맞는지 확인합니다.

운영 키로 바꾸고 모니터링을 시작합니다.

위 엔드포인트·인증·웹훅 구조는 연동 논의를 시작하기 위한 설계 초안이며, 현재 제공되는 실제 API 사양이 아닙니다. 실제 문서는 개발 범위가 확정된 뒤 이 페이지에 게재합니다.

연동을 검토 중이시라면 고객지원으로 사용 중인 시스템과 필요한 데이터를 알려주세요.