통합 방식
라이선스 통합은 키 발급 방식을 내 시스템에 맞게 연결하는 설정이에요.
상품의 전달물(deliverable)에 통합을 연결하면 그 방식으로 발급돼요.
연결하지 않으면 기본값인 payri_managed로 동작해요.
payri_managed (기본)
통합을 연결하지 않은 라이선스 상품의 기본 동작이에요.
페이리가 서명된 키(pyr_live_…)를 자동 발급하고, 활성화·검증·폐기까지 관리해요.
별도 서버 없이 라이선스를 팔 때 가장 간단해요.
- 키당 활성화 허용 수는 상품의
maxActivations로 정해요. (0 = 무제한) - 구독 상품이면 다음 갱신일이 만료일이 돼요.
webhook
결제가 완료되면 페이리가 셀러 서버의 webhook을 호출하고, 응답으로 받은 키를 구매자에게 전달해요.
키 생성 로직을 직접 가지고 있을 때 써요.
| 설정 | 값 |
|---|---|
type | webhook |
webhookUrl | 페이리가 호출할 내 서버 URL |
| 서명 시크릿 | 연결 시 whsec_… 발급 |
페이리가 보내는 요청도 웹훅 시그니처와 같은 방식으로 서명돼요.
발급된 whsec_ 시크릿으로 검증한 뒤, 키를 응답 본문에 담아 빠르게 돌려주세요.
external
페이리는 라이선스 레코드를 만들지 않고, 알림(글로벌 webhook)으로만 통지해요.
권한 부여·키 발급을 셀러 시스템이 전적으로 처리할 때 써요.
- 페이리에 키가 저장되지 않으므로 Licenses API 검증 대상이 아니에요.
- 연결 시 서명 시크릿(
whsec_…)이 발급돼요.
pool
미리 업로드해 둔 키 목록에서 하나씩 꺼내 발급해요.
외부에서 미리 생성한 키(스팀 코드 등)를 소진하는 방식이에요.
- 결제 한 건마다 미소진 키 1개를 소비하고
consumed로 표시해요. - 키가 모두 소진되면 더 발급되지 않으니, 잔여 수량을 모니터링하세요.
shared
모든 구매자가 같은 공용 키를 받아요.
강의 접속 코드·이벤트 쿠폰처럼 1인 1키가 필요 없을 때 써요.
| 설정 | 값 |
|---|---|
type | shared |
sharedKey | 모두에게 전달할 공용 키 |
한눈에 비교
| 방식 | 페이리가 키 저장 | 서명 시크릿 | 검증 API 대상 |
|---|---|---|---|
payri_managed | O (자동 발급) | — | O |
webhook | O (응답 키 저장) | O | O |
external | X | O | X |
pool | O (소진 키 저장) | — | O |
shared | O (공용 키 저장) | — | O |
Last updated on