Petify Console

What is Petify Console?

Petify Console (Petify Admin Console) is the web admin console for partners adopting Petify SaaS. It is the starting point for everything you need to integrate the SDK and Server API: it issues the credentials required for integration and lets you manage usage and billing.

• Console URL: console.petify.petnow.io
• Product / pricing: petnow.io/petify · Pricing

1. Create an account and sign in

1. Go to console.petify.petnow.io.
2. Sign up. You can start using it immediately after sign-up — there is no approval step.
3. Once signed in, you have access to the Dashboard and My Page.

2. Register a payment method (prerequisite for issuing keys)

Register a payment method under Payment Info in My Page. After registering, creating your first API Key or your first Web Integration link (whichever happens first, once per account) automatically grants 50 Integration Credits.

• Integration Credits are applied first to your billable-pet usage (1 Credit = 1 billable pet).
• They expire about 60 days after they are granted; usage after expiry/depletion is charged to your registered payment method.
• Billing is usage-based — a monthly snapshot of registered pets. See Plans and billing below and Pricing.

3. Issue an API Key

The API Key is the Petnow API key used for the SDK license and Server API authentication.

1. Go to API Key Management in My Page.
2. Click Create new key. (If no payment method is registered, a registration prompt appears — see step 3.)
3. Enter a key name and create it; the API Key is shown. The full value is visible only right after creation, so store it somewhere safe.

Use the issued API Key for:

• SDK license — passed as LicenseInfo when creating the camera controller
• Server API — passed as the x-petnow-api-key header on registration / verification / identification calls

• Multiple keys can be active at once, so you can issue a new key and switch over before retiring the old one.
• A deactivated key cannot be reactivated. If you deactivate a key by mistake, create a new one.
• For the step-by-step rotation guide, see API key security on the SDK Getting Started pages.

4. Issue AWS CodeArtifact credentials

The Petnow SDK is distributed through AWS CodeArtifact. To download the SDK you must issue CodeArtifact credentials from the console.

1. Issue the AWS CodeArtifact Key (credentials) in My Page. (Like the API Key, this requires a registered payment method.)
2. Set the install-guide environment variables with the issued values:

export AWS_ACCESS_KEY_ID=<from Petify Console>
export AWS_SECRET_ACCESS_KEY=<from Petify Console>
export AWS_DEFAULT_REGION=<from Petify Console>
export PETNOW_CODEARTIFACT_DOMAIN=<from Petify Console>
export PETNOW_AWS_ACCOUNT_ID=<from Petify Console>
# Platform-specific repository
export PETNOW_IOS_SDK_REPOSITORY=<from Petify Console>       # iOS
export PETNOW_ANDROID_SDK_REPOSITORY=<from Petify Console>   # Android
export PETNOW_NPM_REPOSITORY=<from Petify Console>           # React Native

For the full per-platform install steps, see each getting-started guide:

• iOS Getting Started (Swift Package Manager)
• Android Getting Started (Gradle/Maven)
• React Native Getting Started (npm)

5. Check usage

In Service Usage on My Page you can see your current usage, your Integration Credits balance (remaining Credits / to be applied / expiry date), and the estimated charge.

6. Plans and billing

Plans

Two self-service plans are available, priced per registered pet per month:

Existing accounts on the legacy plan receive a 30-day notice with a migration date. If that date passes with no plan chosen, identification requests may start being refused with PETNOWB2B10012 until a plan is selected under My Page → Billing; selecting either plan clears it. Identification will also require Plus, and a plan without it answers PETNOWB2B10011. Registration and verification are unaffected on every plan. Handle both codes now so the change is a non-event. See Error Codes.

Billing rule: a snapshot on the billing date

Billing is a snapshot of the billable pet profiles registered at the billing date, not a running tally:

• A pet deleted before the snapshot is not counted and consumes no Integration Credit. A profile with no fingerprints yet still counts, so clean up incomplete registrations (see Pet Management).
• Charges already made are not recalculated when a pet is deleted afterwards.
• Integration Credits are applied on each billing date to the pets registered at that time. Example: with 50 Credits and 30 pets kept for two cycles, 30 Credits are used on the first billing date and 20 on the second — the remaining 10 pets on the second date are charged.
• Test pets left registered after your Credits expire become billable — delete them first.

Billing cycle date

Your billing date is the day of the month on which you registered your payment method. A card registered on March 15 means the next snapshot is on April 15, and every month on the 15th after that.

Quick-start checklist

Support

• support@petnow.io