Wallets
Every paid action flows through an ActLayer wallet.
Wallets give agents a bounded budget. Successful actions debit the wallet, failed paid executions refund, and every movement is recorded in the ledger.
How wallet charging works
Balance check
SRG checks that the wallet has enough balance before an action runs.
Row lock before debit
ActLayer re-checks and locks the wallet row before charging to reduce overspend risk.
Ledger entry
Debits, top-ups, refunds, adjustments, and future provider payouts are recorded as ledger entries.
Refund on failure
If capability execution fails after debit, ActLayer writes a refund ledger entry.
Idempotency
Repeated calls with the same Idempotency-Key return the original receipt instead of charging twice.
Production funding
Public wallet funding should use Stripe checkout and signed webhooks. Dev top-ups are local-only.
Production note
The live environment disables development wallet top-ups. Stripe checkout and webhook secrets must be configured before real public paid usage.