> ## Documentation Index
> Fetch the complete documentation index at: https://docs.payzor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentes y billeteras

> Cada agente en Payzor tiene una identidad, un saldo y un rastro de auditoría. Eso es lo que hace que el dinero de las máquinas rinda cuentas.

# Agentes y billeteras

Un **agente** es cualquier programa autónomo que gasta o recibe dinero: un asistente de código comprando cómputo, un agente de investigación contratando a un agente legal, un bot de compras pagando en tu tienda.

Cuando registras un agente, Payzor crea tres cosas de forma atómica:

1. **Identidad**: un `agentId` estable (`agent_...`) y un nombre legible por humanos.
2. **Billetera**: un saldo en el ledger (denominado en USDC) que el agente puede gastar.
3. **Rastro de auditoría**: un registro de solo-anexado de todo lo que ha hecho, con números de secuencia y hashes encadenados.

```json theme={null}
{
  "agentId": "agent_6b75c0e895ba9c3d",
  "name": "E2E Spender",
  "wallet": { "balance": 99856, "currency": "USDC" },
  "status": "active"
}
```

## Cómo se fondean los agentes

| Método                   | Qué pasa                                                                                                                                                                                  |
| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Recarga desde consola    | El propietario acredita el ledger directamente (desarrollo, pruebas y flujos internos).                                                                                                   |
| Depósito on-chain        | El agente tiene direcciones de depósito en Base, Arbitrum, Polygon y Ethereum. Un vigilante detecta el USDC entrante y acredita el ledger automáticamente, emitiendo `deposit.confirmed`. |
| Transferencias recibidas | Otro agente le envía dinero A2A con escrow.                                                                                                                                               |
| Cobros                   | Personas que pagan un link de checkout de Wompi generado por el agente.                                                                                                                   |

## La regla de oro

<Warning>
  Un agente solo puede mover su propio dinero, y solo a través de su propia key. No existen endpoints que acepten un `agentId` para gastar; si existieran, una key filtrada sería una llave maestra. La credencial *es* la frontera.
</Warning>

## Ciclo de vida

* `active`: operación normal.
* `paused`: las validaciones de política rechazan cualquier gasto nuevo; los saldos no se tocan.
* `frozen`: igual que pausado, pero señala un incidente; útil cuando sospechas que una key está comprometida.

Cambia el estado con `POST /agents/:id/status`. La pausa surte efecto en la siguiente evaluación de política; los pagos ya aprobados y en vuelo se completan.

## Por qué las billeteras importan para los negocios

Cuando recibes dinero de un agente, sabes:

* qué `agentId` pagó,
* que la política de su propietario permitió el pago (o que un humano lo aprobó explícitamente),
* y que cada hecho es exportable para contabilidad desde la cadena de auditoría.

Eso es algo que un pago con tarjeta desde una sesión de navegador nunca te podrá decir.