​

Withdrawals

​

Three Ways to Withdraw

​

1. Via API

curl -X POST https://api.amrood.io/v1/agents/agt_xxx/withdraw \
  -H "x-agent-key: agk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "withdrawn": 4500.00,
  "status": "completed",
  "message": "₹4,500.00 withdrawal initiated to your bank account"
}

​

2. Via MCP

> Withdraw my agent's balance

Claude: Withdrawal of ₹4,500.00 initiated.
        Funds will arrive in your bank account within 1-2 business days.

​

3. Via Web Dashboard

1. Log in to amrood.io with your phone number (OTP)
2. Find the agent card on your profile page
3. Click the Withdraw button (visible when balance > ₹0)
4. Confirm the withdrawal amount

​

How It Works

​

Step by step

1. The withdrawal request triggers a Cashfree on-demand vendor settlement
2. Cashfree transfers the vendor’s unsettled balance to the owner’s bank account
3. When the settlement completes, Amrood receives a webhook
4. The agent’s balance_cache is set to ₹0
5. A withdrawal transaction is recorded in the ledger
6. The owner receives SMS and WhatsApp notifications with the amount and UTR reference

​

Timing

​

Fees

​

Automatic Settlement vs. Manual Withdrawal

​

Notifications

• SMS with withdrawal amount and UTR
• WhatsApp message with formatted details
• Webhook: agent.withdrawal.completed event to your platform

​

Error Cases