Skip to Content

통합 방식

라이선스 통합은 키 발급 방식을 내 시스템에 맞게 연결하는 설정이에요.
상품의 전달물(deliverable)에 통합을 연결하면 그 방식으로 발급돼요.
연결하지 않으면 기본값인 payri_managed로 동작해요.

payri_managed (기본)

통합을 연결하지 않은 라이선스 상품의 기본 동작이에요.
페이리가 서명된 키(pyr_live_…)를 자동 발급하고, 활성화·검증·폐기까지 관리해요.
별도 서버 없이 라이선스를 팔 때 가장 간단해요.

  • 키당 활성화 허용 수는 상품의 maxActivations로 정해요. (0 = 무제한)
  • 구독 상품이면 다음 갱신일이 만료일이 돼요.

webhook

결제가 완료되면 페이리가 셀러 서버의 webhook을 호출하고, 응답으로 받은 키를 구매자에게 전달해요.
키 생성 로직을 직접 가지고 있을 때 써요.

설정
typewebhook
webhookUrl페이리가 호출할 내 서버 URL
서명 시크릿연결 시 whsec_… 발급

페이리가 보내는 요청도 웹훅 시그니처와 같은 방식으로 서명돼요.
발급된 whsec_ 시크릿으로 검증한 뒤, 키를 응답 본문에 담아 빠르게 돌려주세요.

external

페이리는 라이선스 레코드를 만들지 않고, 알림(글로벌 webhook)으로만 통지해요.
권한 부여·키 발급을 셀러 시스템이 전적으로 처리할 때 써요.

  • 페이리에 키가 저장되지 않으므로 Licenses API 검증 대상이 아니에요.
  • 연결 시 서명 시크릿(whsec_…)이 발급돼요.

pool

미리 업로드해 둔 키 목록에서 하나씩 꺼내 발급해요.
외부에서 미리 생성한 키(스팀 코드 등)를 소진하는 방식이에요.

  • 결제 한 건마다 미소진 키 1개를 소비하고 consumed로 표시해요.
  • 키가 모두 소진되면 더 발급되지 않으니, 잔여 수량을 모니터링하세요.

shared

모든 구매자가 같은 공용 키를 받아요.
강의 접속 코드·이벤트 쿠폰처럼 1인 1키가 필요 없을 때 써요.

설정
typeshared
sharedKey모두에게 전달할 공용 키

한눈에 비교

방식페이리가 키 저장서명 시크릿검증 API 대상
payri_managedO (자동 발급)O
webhookO (응답 키 저장)OO
externalXOX
poolO (소진 키 저장)O
sharedO (공용 키 저장)O
Last updated on