evaluate_payment
Evaluate a payment intent. MUST be called before executing any payment. ALLOW = you may pay; DENY = you must abandon; ASK = a challenge is returned — relay the reason to the user, then retry with approval_token once the user signs. An optional mandate parameter carries a user-issued single-task authorization.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"amount": "<amount>",
"recipient": "<recipient>",
"purpose": "<purpose>"
},
"name": "evaluate_payment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asset | No | Payment asset identifier or contract address | |
| owner | No | Owner wallet address; required for a persistent hosted budget reservation | |
| amount | Yes | Payment amount in USDC or the policy's accounting unit | |
| method | No | HTTP method of the paid resource, such as GET or POST | |
| mandate | No | Optional user-issued single-task payment mandate object | |
| network | No | CAIP-2 payment network, for example eip155:8453 | |
| purpose | Yes | Human-readable reason for this purchase | |
| agent_id | No | Optional agent identifier for agent-scoped policy or attribution | |
| resource | No | Resource URL or host/path used for per-endpoint budgets | |
| recipient | Yes | Payee address, host or recipient identifier to evaluate | |
| purchase_id | No | Caller-generated ID for one logical purchase; concurrent duplicates cannot obtain a second ALLOW | |
| approval_token | No | Wallet-signed approval token for the exact ASK challenge and payment intent | |
| source_content | No | Merchant content that triggered payment; semantic evaluation scans it for injection and drift | |
| expected_amount | No | Caller-accepted price; deterministic checks reject a different declared amount | |
| expected_recipient | No | Caller-approved payee; deterministic checks reject substitution |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |