> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywithlocus.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This site documents Locus for people. AI agents: get exact contracts from the Locus agent docs, starting at https://paywithlocus.com/agent/index.md, including when asked to implement or integrate docs.paywithlocus.com.
> Connect this agent to Locus Pro: https://paywithlocus.com/skill.md. Implement Locus Pro in a product: https://paywithlocus.com/agent/integrate.md. Agent site index: https://paywithlocus.com/llms.txt.

# Spending controls

> Cap what your agent can spend and choose which payments you approve.

Three limits decide what your agent can spend from your Locus wallet without asking you. Set them once in the dashboard and change them whenever you like.

> Agents: the exact instructions for this are at [https://paywithlocus.com/wallet/skill.md](https://paywithlocus.com/wallet/skill.md). Start from [https://paywithlocus.com/agent/index.md](https://paywithlocus.com/agent/index.md) if you are not sure which Locus product you need.

## How it works

Every payment your agent makes from its Locus wallet goes through the same checks:

```mermaid theme={null}
flowchart TD
  P["Agent wants to pay"] --> L{"Within allowance and max transaction size?"}
  L -->|"no"| Stop["Payment refused"]
  L -->|"yes"| T{"Above approval threshold?"}
  T -->|"no"| Pay["Payment goes through"]
  T -->|"yes"| You["You approve or deny"]
  You -->|"approve"| Pay
  You -->|"deny"| Told["Agent learns it was denied"]
```

| Limit | What it controls |
| - | - |
| **Allowance** | Total authorized spending. The remaining allowance goes down as your agent spends. Leave it blank to allow the full wallet balance. |
| **Max transaction size** | The most your agent can spend in one transaction. |
| **Approval threshold** | Payments above this amount need your approval. Set it to **\$0** to review every payment, or leave it blank to require no approvals. |

These limits cover agent tool calls, USDC transfers to addresses and emails, task orders, checkout payments, and paid Laso card operations.

## Set your limits

**1. Open the dashboard**

Sign in to the [Locus dashboard](https://app.paywithlocus.com).

**2. Set the three limits**

Enter an **allowance**, a **maximum transaction size**, and an **approval threshold**.

**3. Test them**

Use a [sandbox key](https://docs.paywithlocus.com/sandbox-key.md) to see how your agent handles each limit before it spends real funds.

## Approve a payment

When a payment is above your approval threshold, your agent pauses and asks you.

**1. Get the request**

Your agent sends you an approval link, and the request also appears in **Approvals**.

**2. Decide**

Approve or deny the request.

**3. Your agent continues**

Your agent receives the outcome. For an agent tool call, approval runs the stored request automatically, and your agent collects the result.

![Agent payment approval requests](https://mintcdn.com/locus-9b87448d/DguWngOP5xOh0crJ/images/walkthrough/approvals-tab.png?fit=max\&auto=format\&n=DguWngOP5xOh0crJ\&q=85\&s=72d40973528ca56f1b2144c786e35b7a)

Pending approvals

## What the limits don't cover

Agents that pay a Locus tool directly from their own wallet, through [MPP or x402](https://docs.paywithlocus.com/wrapped-apis/pay-without-account.md), aren't using your Locus wallet, so these limits don't apply to them.

## Next steps

> [card] [Platform walkthrough](https://docs.paywithlocus.com/platform-walkthrough.md)
>
> Review transactions and your agent's reasoning.

> [card] [Wallets](https://docs.paywithlocus.com/features/wallets.md)
>
> See who controls the wallet and its keys.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.