> For the complete documentation index, see [llms.txt](https://docs.robotmoney.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.robotmoney.com/introduction/readme.md).

# Welcome

RobotMoney is infrastructure that connects AI agents to money.

The agentic economy is here. AI agents can now spend money. Humans don’t trust them to. 

RobotMoney makes agent payments trustworthy. One API to authorize, pay, and prove every agent payment. 

## Banking and Payments for AI Agents

### 1. Every Agent Gets An Account

The goal is one API call that opens an account for an agent, with no bank required. Today the setup is several production steps. A business signs up, creates a tenant agent with `POST /v1/agents`, receives a one-time agent key, and exchanges it for a five-minute token. The [Quickstart](/introduction/quickstart.md) shows the current path.

### 2. A Verified Business Adds Fiat

A verified business will add fiat through a partner. It will fund from a bank, pay a vendor bank account, or use a card. The rules stay the same. The receipts stay the same. Fiat funding, payouts, and cards are not available in the public product today.

### 3. RobotMoney Decides Before Money Moves

An agent asks for a decision with `POST /v1/authorizations`. RobotMoney checks the business policy, agent limits, counterparty, evidence, and current business context in the same request. It returns `approved`, `needs_review`, or `blocked`, with reason codes and a recorded decision. People see the exceptions that need review.

### 4. It Pays On Any Rail

An approved internal authorization can create a sandbox payment and settle USDC on Base Sepolia. The purchase execution API is also implemented for Base Sepolia but remains default off until its controlled staging smoke passes. Fiat movement and cards are planned. RobotMoney never holds the funds on any rail.

### 5. Every Decision And Payment Produces Proof

Every recorded decision and payment action writes to the tenant audit chain. New tenants start with the database hash-chain guarantee. On-chain anchoring is available by operator promotion for paid and pilot tenants on Base Sepolia. Base mainnet anchoring remains fenced. Read more in [Proof](/concepts/proof.md).

## A First Integration

```typescript
import { Brain } from "@braindotfi/brain-core-sdk";

const agent = new Brain({
  agentApiKey: process.env.BRAIN_AGENT_API_KEY!,
  environment: "sandbox",
});

const decision = await agent.authorizations.create({
  idempotencyKey: crypto.randomUUID(),
  execution: "external",
  action_type: "ach_outbound",
  amount: "100.00",
  currency: "USD",
  destination_counterparty_id: "cp_vendor",
  reference: "inv-first-001",
});

console.log(decision.decision, decision.reason_code);
```

Use `reference` for an invoice number that does not identify a RobotMoney Ledger invoice. `invoice_id` is a strict link to an invoice in the authenticated tenant's Ledger.

### What Happens Next

1. **Decision: Live.** RobotMoney records the result before money moves. For `execution: "external"`, your own rail decides what to do with it.
2. **Payment: Sandbox.** An approved internal authorization can create a linked payment, require a recorded human approval, and settle test USDC on Base Sepolia. See [Authorizations](/govern/authorizations-api.md).
3. **Proof: Live.** Read the audit trail and canonical proof after the action. New tenants start in the database hash chain. Paid and pilot tenants can be promoted to Base Sepolia anchoring. See the [Proof API](/api-reference/proof-api.md).

## Go Deeper

* Start with the production decision flow in the [Quickstart](/introduction/quickstart.md).
* Read the [Authorizations API](/govern/authorizations-api.md).
* Read the live decision-only [Purchase Decisions API](/govern/purchase-decisions-api.md).
* Read the default-off Base Sepolia sandbox [Purchase Execution API](/govern/purchase-execution-api.md).
* Read the read-only [Usage API](/govern/usage-api.md).
* Learn the mental model in [Concepts](/concepts/overview.md).
* Learn the six-layer stack in [Protocol](/protocol/overview.md).
