API ReferenceAgent
Propose a payment
Propose a payment (30/min per agent; 429 above)
Authorization
agent AuthorizationBearer <token>
Per-agent API key from POST /v1/agents
In: header
Request Body
application/json
mandate_id*string
agent_id*string
idempotency_key*string
paypal_order_id?string
Merchant-created AUTHORIZE order (preferred). Do not combine with payee/currency/items.
payee?
Vaulted path only (untrusted)
currency?string
Vaulted path only
items?array<>
Vaulted path only (untrusted)
context?array<>
Untrusted context the agent saw; scored for injection, advisory only
agent_rationale?string
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/agent/payments" \ -H "Content-Type: application/json" \ -d '{ "mandate_id": "string", "agent_id": "string", "idempotency_key": "string" }'{ "payment_id": "string", "decision": "approve", "status": "rejected", "evaluation": { "decision": "approve", "proposal_hash": "string", "amount_minor": 0, "checks": [ { "check": "string", "pass": true, "detail": "string" } ], "risk": [ { "signal": "string", "severity": "low", "detail": "string" } ], "reasons": [ "string" ] }, "approval_id": "string", "paypal": { "order_id": "string", "authorization_id": "string", "capture_id": "string" }, "error": "string"}