How `payman.ask()` Works

One Function. Infinite Power.

payman.ask() is how your AI agent interacts with money — using natural language. You send a message like:

await payman.ask("Send $10 to Jane for lunch");

And Payman handles the rest:

It’s like having a finance team inside a single function.

These all work in both test mode (TSD) and live wallets.

Send a payment

await payman.ask("Send $5 to Kevin for snacks");

Create a new payee

await payman.ask("Add a payee named Riya with USDC wallet 0xabc...");

Check balance

await payman.ask("What's my balance in the USD wallet?");

Trigger policy approval

await payman.ask("Send $5000 to Marketing budget");

If this exceeds your daily or per-payment limit, the request will be flagged for approval — based on your wallet’s policy.

Each time you call payman.ask(), the following happens:

🔍 Intent Parsing — The message is sent to the Payman Agent, which understands what action is being requested.
🧠 Policy Evaluation — The agent checks your wallet’s limits and spending rules.
🧾 Execution or Request — If allowed, the action happens instantly. If not, it’s queued for user approval.
✅ Structured Response — You get a JSON response detailing what happened (or what needs approval).