Skip to main content

The spend limit

The human who owns the account sets a maximum for any single payment in the Laso dashboard under Spend limit. It defaults to $1,000 and ranges from $1 to $50,000. It applies to every payment agentX402Pay makes: Laso routes, including /send-bank-payment, and external url endpoints alike. A payment above it is refused before anything is signed. An agent can read it but not change it. getAgentSpendLimit returns the current value and its bounds. setAgentSpendLimit refuses agent sessions. Check an amount against the limit before paying rather than waiting to be refused.

When a payment is refused

Do not split an over-limit payment into smaller ones. Two $600 transfers to get under a $1,000 limit is not a workaround. It violates what the owner asked for, whether the pieces are sent in one burst or spread across a session.
Stop, do not retry with a different amount, and tell your human the payment is over their spend limit. Name the amount attempted and the limit hit so they can raise it in the dashboard, approve a smaller amount, or pay it themselves.

Activity log

Every external url payment shows up in the agent’s activity list on the dashboard, settled or failed. A settled record carries the on-chain signature, network, payer, and amount. A failed record carries a reason: Payments to Laso’s own routes are not recorded here. They appear as ordinary product activity (cards, gift cards, payouts).