Motor de Políticas

El Motor de Políticas es la razón por la que se le puede confiar una billetera a un agente. Antes de que se ejecute cualquier pago o transferencia, Payzor evalúa la política del agente. Si la respuesta es no, no se mueve nada y el agente recibe un rechazo estructurado que puede leer y ante el que puede reaccionar.

Las reglas

Regla	Alcance	Efecto
`maxSingleTransaction`	límite duro	Bloquea cualquier transacción por encima del tope.
Máximo por transacción del workspace	límite duro	Techo a nivel de propietario que se aplica encima del tope propio del agente (gana el más bajo de los dos).
`allowedCategories`	límite duro	El gasto se etiqueta con categorías (`data_apis`, `compute`, `agent_transfer`, `shop`, `services`). Todo lo que quede fuera de la lista se bloquea.
Topes diarios	límite duro	Límite diario del agente y tope diario de volumen del workspace a nivel de propietario.
`requireHumanApprovalAbove`	revisión humana	Por encima de este umbral el pago no se ejecuta; espera a un humano.

La distinción importa:

Límites duros → rechazo inmediato, determinista, sin humanos de por medio.
Revisión humana → se pausa como aprobación pendiente y se avisa a la persona en tiempo real.

Humano en el circuito (HITL)

Cuando un pago supera el umbral de revisión:

{
  "success": false,
  "pendingApproval": true,
  "reason": "Monto $200 supera umbral de aprobación humana ($30 USDC)"
}

En ese mismo instante:

Se crea un registro de aprobación pendiente (con caducidad).
Se dispara un webhook approval.required a todos los endpoints registrados.
La consola muestra la cola de aprobaciones.

Después un humano concede o rechaza:

curl -X POST https://tu-host-payzor/approvals/apr_xxx/grant \
  -H "Authorization: Bearer <console_jwt>"

Solo entonces se mueve el dinero. Los rechazos se registran igual que cualquier pago bloqueado.

Gasto preautorizado

Algunos flujos no deberían volver a preguntarle a un humano por cada cargo, pero tampoco pueden saltarse los límites. Eso es lo que significa preAuthorized en Payzor:

Cuando el humano de un agente acepta el presupuesto de un PayLink, los cargos que se cobren contra ese presupuesto se saltan únicamente la regla de revisión humana. Todos los límites duros siguen aplicando.

Una aprobación, muchos cargos, cero ambigüedad sobre quién dijo que sí.

Leer una política

curl https://tu-host-payzor/balance -H "Authorization: Bearer pz_sk_..."

devuelve la política activa junto con el saldo, para que los agentes puedan autoverificarse antes de intentar un pago.

Primeros pasos

Conceptos clave

Guías

Motor de Políticas

Motor de Políticas

Las reglas

Humano en el circuito (HITL)

Gasto preautorizado

Leer una política

​Motor de Políticas

​Las reglas

​Humano en el circuito (HITL)

​Gasto preautorizado

​Leer una política

Motor de Políticas

Las reglas

Humano en el circuito (HITL)

Gasto preautorizado

Leer una política