운영 전환 체크리스트

Live mode 배포 전에 아래 항목을 확인해요.

인증과 키

• Live API 키를 발급해요.

웹훅

• Live 엔드포인트를 등록하고 수신 URL·mode·이벤트·상품 범위를 확인해요.
• 원본 본문 서명 검증을 적용하고 webhook-id·webhook-timestamp·webhook-signature를 확인해 위조 본문을 거절해요.
• 10초 안에 2xx 응답을 보내기 전 이벤트를 저장하고, 처리할 수 없으면 2xx를 보내지 않아요.
• 이벤트 id 중복 제거를 적용하고, 순서가 보장되지 않으므로 createdAt 오름차순으로 처리하며 이미 처리한 id에는 2xx를 반환해요.

Checkout과 멱등성

• Live 리디렉트 호스트: successUrl, cancelUrl, 포털 복귀 URL의 호스트를 등록해요.
• POST 멱등 키를 라이선스 앱 API 외 모든 v1 POST에 보내고 재시도에는 같은 키와 본문을 사용해요.
• 복귀 주소만으로 결제를 확정하지 말고 order.paid 서명 또는 서버의 세션·주문 조회로 확인해요.

라이선스

• license.issue 엔드포인트를 mode·상품 조합마다 하나 등록하고, 같은 이벤트 id에는 같은 키를 반환해요.
• license.issue 서명을 검증해요.
• 앱 API 응답의 서명·요청 nonce 일치·5분 이내 issuedAt을 검증하고, deactivate에는 서버 발급 활성화 id를 보내요.
• 현재·다음 공개 키를 앱에 내장하고 SDK 내장 표를 최신으로 유지하며, 다음 키 공지 때 앱을 미리 갱신해요.