Petify Console

Petify Console란?

Petify Console(Petify Admin Console)은 Petify SaaS를 도입하는 파트너사를 위한 웹 관리자 콘솔입니다. SDK·Server API 연동에 필요한 인증 정보를 발급하고, 사용량과 결제를 관리하는 모든 작업의 출발점입니다.

• 콘솔 주소: console.petify.petnow.io
• 제품 소개 / 가격: petnow.io/ko/petify · 가격 안내

1. 계정 생성 및 로그인

1. console.petify.petnow.io에 접속합니다.
2. 회원가입합니다. 별도 승인 절차 없이 가입 즉시 사용할 수 있습니다.
3. 로그인하면 Dashboard와 My Page(마이페이지)에 접근할 수 있습니다.

2. 결제수단 등록 (키 발급의 선행조건)

My Page의 Payment Info에서 결제수단을 등록합니다. 등록 후 첫 API Key 또는 첫 Web Integration 링크를 생성하면(둘 중 먼저 1회) 50 Integration Credits가 자동 지급됩니다.

• Integration Credits는 등록되는 반려동물(billable pet) 사용량에 우선 적용됩니다(1 Credit = billable pet 1마리).
• 지급일로부터 약 60일 후 만료되며, 만료/소진 이후의 사용량은 등록된 결제수단으로 과금됩니다.
• 과금은 사용량 기반이며, 매월 결제일에 등록된 펫을 스냅샷으로 집계합니다. 아래 플랜과 과금과 가격 안내를 참고하세요.

3. API Key 발급

API Key는 SDK 라이선스와 Server API 인증에 사용하는 Petnow API 키입니다.

1. My Page의 API Key Management로 이동합니다.
2. 새 키 생성을 클릭합니다. (결제수단 미등록 시 등록 안내 팝업이 표시됩니다 — 3단계 참고.)
3. 키 이름을 입력하고 생성하면 API Key가 표시됩니다. 이 값은 생성 직후에만 전체를 확인할 수 있으니 안전한 곳에 보관하세요.

발급한 API Key는 다음에 사용합니다:

• SDK 라이선스 — 카메라 컨트롤러 생성 시 LicenseInfo로 전달
• Server API — x-petnow-api-key 헤더로 등록/인증/식별 호출 시 전달

• 여러 키를 동시에 활성 상태로 둘 수 있으므로, 새 키를 발급해 전환한 뒤 기존 키를 비활성화하세요.
• 비활성화한 키는 다시 활성화할 수 없습니다. 실수로 비활성화했다면 새 키를 생성하세요.
• 단계별 키 교체(rotation) 가이드는 SDK 시작하기 문서의 API key security를 참고하세요.

4. AWS CodeArtifact 자격 증명 발급

Petnow SDK는 AWS CodeArtifact를 통해 배포됩니다. SDK를 내려받으려면 콘솔에서 CodeArtifact 자격 증명을 발급해야 합니다.

1. My Page에서 AWS CodeArtifact Key(자격 증명)를 발급합니다. (API Key와 마찬가지로 결제수단 등록이 선행되어야 합니다.)
2. 발급된 값으로 설치 가이드의 환경 변수를 설정합니다:

export AWS_ACCESS_KEY_ID=<Petify Console에서 제공>
export AWS_SECRET_ACCESS_KEY=<Petify Console에서 제공>
export AWS_DEFAULT_REGION=<Petify Console에서 제공>
export PETNOW_CODEARTIFACT_DOMAIN=<Petify Console에서 제공>
export PETNOW_AWS_ACCOUNT_ID=<Petify Console에서 제공>
# 플랫폼별 저장소
export PETNOW_IOS_SDK_REPOSITORY=<Petify Console에서 제공>       # iOS
export PETNOW_ANDROID_SDK_REPOSITORY=<Petify Console에서 제공>   # Android
export PETNOW_NPM_REPOSITORY=<Petify Console에서 제공>           # React Native

플랫폼별 전체 설치 절차는 각 시작하기 문서를 참고하세요:

• iOS 시작하기 (Swift Package Manager)
• Android 시작하기 (Gradle/Maven)
• React Native 시작하기 (npm)

5. 사용량 확인

My Page의 Service Usage에서 현재 등록 기준 사용량과 Integration Credits 잔량(잔여 Credits / 적용 예정 / 만료일), 예상 청구 금액을 확인할 수 있습니다.

6. 플랜과 과금

플랜

셀프서비스 플랜은 두 가지이며, 등록된 펫 1마리당 월 단위로 과금됩니다:

레거시 플랜을 사용 중인 기존 계정에는 이전 예정일과 함께 30일 전 안내가 발송됩니다. 예정일까지 플랜을 선택하지 않으면, 이후 식별 요청이 PETNOWB2B10012로 거부될 수 있습니다. My Page → Billing에서 두 플랜 중 어느 것이든 선택하면 해제됩니다. 식별에는 추가로 Plus가 필요해지며, 포함되지 않은 플랜은 PETNOWB2B10011을 반환합니다. 등록과 검증은 모든 플랜에서 영향이 없습니다. 두 코드를 미리 처리해 두면 전환 시 영향이 없습니다. 에러 코드를 참고하세요.

과금 규칙: 결제일 스냅샷

과금은 누적 집계가 아니라 결제일에 등록되어 있는 과금 대상 펫 프로필의 스냅샷입니다:

• 스냅샷 전에 삭제한 펫은 집계되지 않으며 Integration Credit도 소모하지 않습니다. 지문이 아직 없는 프로필도 집계되므로 미완료 등록을 정리하세요 (펫 관리 API 참고).
• 이미 청구된 금액은 이후에 펫을 삭제해도 재계산되지 않습니다.
• Integration Credits는 매 결제일에 그 시점의 등록 펫에 적용됩니다. 예: Credits 50개, 펫 30마리를 두 주기 동안 유지하면 첫 결제일에 30 Credits, 두 번째 결제일에 20 Credits가 사용되고 두 번째 결제일의 나머지 10마리가 과금됩니다.
• Credits 만료 후에도 등록된 채 남아 있는 테스트 펫은 과금 대상이 됩니다 — 먼저 삭제하세요.

결제 주기 기준일

결제일은 결제수단을 등록한 날짜입니다. 3월 15일에 카드를 등록했다면 다음 스냅샷은 4월 15일이며, 이후 매월 15일에 집계됩니다.

빠른 시작 체크리스트

지원

• 콘솔 내 채널톡으로 문의
• support@petnow.io