Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.praxis-ai.com/llms.txt

Use this file to discover all available pages before exploring further.

Once credits have been purchased, the next question is where they sit and how they move. Pria has a three-tier credit model with explicit rules for pooling, manual transfers, automatic top-up, and audit. This page is the reference for Admins managing those flows.

​
Three-tier credit model

Credits live at three levels. Each level has its own balance, its own usage counter, and clear rules for how it can be funded.

Account

The master pool for organizations operating multiple Digital Twins. Funded by purchase. Distributes credits down to instances.

Digital Twin (Instance)

Per-instance balance. Funded by transfer from the parent Account. Drawn down by user interactions when pooling is enabled.

User

Personal balance attached to each user. Funded by personal purchase or by an Admin awarding bonus credits. Drawn down whenever the user is acting outside a pooled instance.

​
Credit pooling

Each Digital Twin has a Pool Credits flag that decides who pays for member activity.
All members of the Digital Twin draw from the instance balance. A user with zero personal credits can still chat freely as long as the instance has credits. This is the standard setup for schools, classrooms, and corporate teams.
Each member pays from their personal credit balance. The instance balance is not consumed by member chat. Use this when you want the Digital Twin to provide branding and configuration but each user is responsible for their own usage.
Toggle this in Admin → Configuration for the Digital Twin.

​
Manual transfer

Admins can move credits between an Account and any Digital Twin owned by that Account at any time, in either direction.
1

Open the Account view

Go to Admin → Account (or the Accounts section if you manage multiple).
2

Choose the transfer

Select the source (Account or Instance) and destination, then enter the credit amount.
3

Confirm

The balances are updated immediately and an AccountTransfer record is written so the move shows up in the audit trail.
Manual transfers can also pull credits back from an instance into the parent Account — useful at the end of a term or when winding down a Digital Twin.

​
Automatic top-up — Transfer Modes

Each Account has a Transfer Credits Mode that decides whether the platform should automatically refill an instance when its balance drops.

Never (0)

No automatic movement. Admins must initiate every transfer manually. Use this when you want strict per-instance budgeting.

Admin Only (1)

Automatic refill is disabled, but Admins can still initiate transfers from the Account → Instance manually. Equivalent to “Never” for the auto-refill engine.

Automatic (2)

When an instance with Pool Credits ON falls below the low-balance threshold, Pria automatically pulls credits from the parent Account.

​
How automatic top-up works

When Transfer Credits Mode = Automatic and a pooled instance hits the threshold:
1

Trigger

Instance balance falls to 500 credits or below during an interaction.
2

Transfer amount

Pria pulls up to 1,000 credits from the parent Account — capped at whatever the Account currently has available.
3

Apply

The Account is debited, the instance is credited, and an AccountTransfer record is written with transferMode: 2.
4

Notify

A confirmation email is sent to the user whose interaction triggered the refill.
If the parent Account does not have enough credits to refill, the interaction is denied with a “No credits left” message and a critical alert email is sent to the Account manager so they can top the Account up.

​
When an instance is deleted

Deleting a Digital Twin does not burn its credits. Any remaining balance returns to the parent Account so it can be redistributed to other instances. If the deleted instance had no parent Account, the credits are written off — set up the Account relationship before deletion if you need to preserve them.

​
Awarded credits

In addition to pooled funding, Admins can grant bonus credits to a specific user inside a Digital Twin. This shows up on the user record as creditAwarded and is reflected in the user’s personal credit display.

Use cases

Welcome bonus for early adopters, classroom-specific grants, contest prizes, manual goodwill replacements after a bad experience.

Audit

Each award is timestamped (creditAwardedDate) and tied to the membership record, so you can audit who gave what and when.
To award credits, open the user from Admin → Users, edit their membership, and enter the credit amount.

​
Trial credits and conversion

New Accounts seed every user with 50 credits / 14 days of trial access. Trial credits look and behave like purchased credits — they’re spent on the same model, just with a clock attached.
When a trial expires or runs out, the user sees a prompt to add credits. Their account remains active; only chat is gated. Any credits subsequently purchased land on the same balance and clear the gate immediately.
If you want to extend a trial for a specific user or Account, the Praxis AI team can issue a one-off bonus. Contact the Praxis AI team at humans@praxis-ai.com.

​
Low-balance alerts

When a pooled instance balance crosses below the configured threshold, Pria sends a courtesy email so the people responsible for the balance hear about it before the lights go out.

Default threshold

500 credits — fires once per crossing (no spam if the balance hovers near the line).

Recipients

The user whose interaction triggered the call, and — on the failure path — the Account manager email.
When Transfer Credits Mode is set to Automatic and the parent Account has enough credits, auto-refill handles the top-up before a low-balance email is needed.

​
Reading the audit trail

Every credit movement that involves an Account writes an AccountTransfer record. Together these form the canonical ledger for your organization’s credit movements.
FieldMeaning
userWho triggered the transfer (or who was active when auto-refill fired)
institutionDestination Digital Twin
accountSource Account
creditsAmount moved
transferMode1 = Admin-initiated, 2 = automatic top-up
createdTimestamp
You can review transfer history in Admin → Account → Transfers. Filter by instance to investigate a specific Digital Twin’s funding history.