키 검증 연동
구매자에게 발급된 라이선스 키는 Licenses API로 검증·활성화해요.
구매자 앱이 직접 페이리를 부르는 게 아니라, 내 서버가 API 키로 대신 호출하는 구조를 권장해요.
권장 구조
API 키(pk_live_…)는 서버에만 두세요.
앱·브라우저에 키를 심으면 누구나 다른 사람의 라이선스를 조회·변경할 수 있어요.
검증 후 활성화
대표 패턴은 다음과 같아요.
- 앱이 키와 디바이스 식별자(UUID)를 내 서버로 보내요.
- 내 서버가
POST /v1/licenses/activate를 호출해요. (activationId에 디바이스 UUID) - 성공하면 사용을 허용하고,
409 MAX_ACTIVATIONS_REACHED(활성화 초과)면 거부해요. - 이후 주기적으로
POST /v1/licenses/verify로 상태를 다시 확인해요.
상태별 처리
result | 앱 동작 |
|---|---|
valid | 사용 허용 |
expired | 갱신·재구매 안내 |
revoked | 사용 차단 |
not_found | 잘못된 키 안내 |
디바이스 교체
활성화 수가 한도에 찼는데 기기를 바꿔야 한다면, 기존 활성화를 POST /v1/licenses/deactivate로 해제한 뒤 새 기기를 활성화하세요.
external 통합으로 발급한 키는 페이리에 레코드가 없어 이 API로 검증할 수 없어요.
이 경우 검증은 셀러 시스템에서 직접 처리해요.
Last updated on