Skip to main content

​
Agent Wallets

Every agent has a wallet — a balance of real INR that the agent can spend within its policies.

​
How Funding Works

  1. Call POST /v1/agents/{id}/fund with an amount and payment method
  2. You receive a payment_session_id and payment link
  3. The human owner completes the payment (UPI, card, netbanking)
  4. Cashfree processes the payment and splits 100% to the agent’s vendor
  5. Amrood receives the webhook, credits the agent’s balance

​
Balance Model

{
  "available": 8500.00,
  "total_funded": 50000.00,
  "total_spent": 41500.00
}
  • available — current spendable balance
  • total_funded — lifetime funding received
  • total_spent — lifetime amount spent (including fees)

​
Agent-to-Agent Transfers

On-network transfers between agents use Cashfree Easy Split adjustments:
  • DEBIT adjustment on the sender’s vendor
  • CREDIT adjustment on the receiver’s vendor
  • Instant, near-zero cost (0.5%, min ₹1)

​
Settlement

Unused agent balance settles to the owner’s bank account on the configured schedule (T+1 by default at 11 AM IST). You can trigger immediate withdrawal via POST /v1/agents/{id}/withdraw.