운영 전환

샌드박스 환경에서 개발과 테스트를 완료한 후, 운영(Live) 환경으로 전환하는 절차입니다.

환경 구분

항목샌드박스 (Sandbox)운영 (Live)
목적개발/테스트실제 주문/제작
가격샌드박스 전용 가격 (sandboxPriceBase)실제 가격 (priceBase 또는 커스텀 가격)
충전금테스트 충전금실제 충전금
personal 계정사용 가능사용 불가
주문 후 흐름결제완료(PAID)에서 멈춤 — 제작/배송 진행 안 함제작 → 출고 → 배송완료까지 전체 흐름 진행

운영 환경 접근 제어

운영 환경에서는 계정 타입에 따라 API 접근이 제어됩니다.

환경동작
샌드박스 환경모든 요청 통과
운영 환경 — personal 계정사용 불가 (403)
운영 환경 — business 계정허용
personal 계정 응답 (403)
{
  "success": false,
  "message": "운영 환경에서는 personal 계정으로 API를 호출할 수 없습니다",
  "errors": ["personal 계정은 샌드박스 환경만 사용 가능합니다"]
}

전환 체크리스트

1. 계정 타입 확인

  • business 타입의 계정을 보유하고 있는지 확인
  • personal 계정은 운영 환경에서 사용 불가

2. API Key (Live)

  • business 계정으로 전환 완료 후, 파트너 포털 > 설정 > API Key에서 운영(Live) 환경 Key 발급
  • 클라이언트 코드의 API Key를 운영용으로 교체
  • 샌드박스 Key와 운영 Key는 별도로 관리됨 (서로 다른 Key를 발급받음)

3. 충전금 잔액

  • 운영 환경 충전금이 충분한지 확인
  • 충전금 환경은 별도 관리됨 (샌드박스 충전금과 운영 충전금은 분리)

4. 웹훅 URL 업데이트

  • 운영 환경용 웹훅 수신 URL로 변경 (PUT /webhooks/config)
  • 테스트 이벤트 전송으로 연동 확인 (POST /webhooks/test)
  • 서명 검증(HMAC-SHA256) 정상 동작 확인
  • 주문 이벤트 수신 경로 확인: order.created, order.cancelled, order.item_cancelled, shipping.departed, shipping.delivered 등 핵심 9종 모두 처리 준비 완료되어 있는지 점검

5. API 엔드포인트

  • 클라이언트 코드의 base URL을 운영 도메인으로 변경

6. 가격 확인

  • GET /book-specs로 운영 환경 가격 확인
  • 커스텀 가격이 설정되어 있으면 해당 가격이 적용됨
  • 샌드박스에서는 가격 필드가 null로 반환되었을 수 있으므로, 운영에서 실제 가격 재확인

7. 테스트

  • 운영 환경에서 전체 워크플로우 1회 테스트 — 실제 사용하는 생성 방식에 맞춰 재현
  • TEMPLATE 방식: 판형 조회 → 책 생성(creationType=TEMPLATE) → 표지/내지 템플릿 적용 → finalize → 주문 생성
  • PDF_UPLOAD 방식: 판형 조회 → 책 생성(creationType=PDF_UPLOAD, pageCount 포함) → 표지/내지 PDF 업로드 → finalize → 주문 생성
  • MIX_COVER_TEMPLATE 방식: 판형 조회 → 책 생성(creationType=MIX_COVER_TEMPLATE) → 표지 템플릿 + 내지 PDF 업로드 → finalize → 주문 생성
  • 웹훅 이벤트 수신 확인 (적어도 order.created, shipping.departed)
  • 부분 취소를 운영에서 쓸 계획이라면 POST /orders/{orderUid}/items/{itemUid}/cancel도 1회 시험 호출

관련 문서