Step 7: 운영 환경 전환 체크리스트

Sandbox에서 Live 환경으로 전환하기 위한 사전 조건과 체크리스트를 안내합니다.

사전 조건

Live 환경으로 전환하려면 다음 조건이 충족되어야 합니다.

사업 협의 완료: 스위트북 담당자와 사업 협의(가격, 물량, 납기 등)가 완료되어야 합니다.
Business 계정: 파트너 포털에서 Business 계정으로 전환이 완료되어야 합니다.

Live 환경에서의 주문은 실제로 인쇄 및 배송됩니다. 테스트 목적이라면 반드시 Sandbox 환경을 사용하세요.

전환 체크리스트

아래 항목을 순서대로 확인하세요.

사업 협의 완료 (스위트북 담당자 확인)
Business 계정 전환 완료
Live API Key 발급
Base URL 변경: api-sandbox.sweetbook.com → api.sweetbook.com
실제 충전금 충전 (파트너 포털에서 결제)
웹훅 URL을 운영 환경 주소로 변경
IP 화이트리스트 설정 (권장)
에러 핸들링 및 재시도 로직 확인
충전금 잔액 모니터링 설정
첫 Live 주문 테스트 (실제 인쇄됨!)

코드 변경 사항

Sandbox에서 Live로 전환할 때 변경해야 하는 항목은 Base URL과 API Key 두 가지뿐입니다.

diff

- const BASE_URL = 'https://api-sandbox.sweetbook.com/v1';
- const API_KEY = 'sandbox_sk_...';
+ const BASE_URL = 'https://api.sweetbook.com/v1';
+ const API_KEY = 'live_sk_...';

API 인터페이스는 Sandbox와 Live가 완전히 동일합니다. URL과 Key 외에 코드를 변경할 필요가 없습니다. 환경변수로 관리하면 배포 환경에 따라 자동 전환할 수 있습니다.

제작 및 배송 SLA

Live 환경에서 주문 이후 제작 및 배송에 소요되는 시간은 다음과 같습니다.

단계	소요 기간	비고
제작	영업일 기준 3~4일	주문 확정(CONFIRMED) 이후
배송	1~2일	한진택배를 통한 배송

공휴일, 연휴 기간에는 제작 일정이 지연될 수 있습니다.shipping.departed 웹훅 이벤트에 송장번호(tracking_number)와 택배사(tracking_carrier) 정보가 포함됩니다.

불량 처리

인쇄 불량이 발생한 경우 파트너 포털을 통해 불량 접수를 진행합니다.

접수 방법: 파트너 포털에서 해당 주문의 불량 접수 + 불량 사진 첨부
재제작 소요: 영업일 기준 3~4일 (불량 확인 후)
비용: 인쇄 불량으로 확인된 경우 추가 비용 없이 재제작

불량 접수 시 불량 부분이 확인 가능한 사진을 반드시 첨부해 주세요. 원본 이미지 해상도 부족으로 인한 품질 저하는 불량 대상에 포함되지 않습니다.