Paga cualquier API x402 con la moneda que ya tienes

Un endpoint x402 responde 402 Payment Required y pide USDC. ROZO paga los que piden USDC en Base. Tu agente puede tener otra moneda en otra red. Recarga un saldo de ROZO una vez con lo que tienes, y cada llamada x402 posterior se paga desde ese saldo en segundos.

Tres comandos

Si tu agente puede ejecutar un comando de shell, esta es toda la integración.

# 1. Recarga el saldo una vez. Muestra una dirección de depósito de un solo uso; págala desde tu propia wallet.
npx @rozoai/checkout x402 topup 20 --with usdt-solana

# 2. Llama a un endpoint de pago. Lee el 402, ROZO firma y la solicitud se reenvía con el pago.
npx @rozoai/checkout x402 pay https://api.example.com/v1/search --method POST --body '{"q":"..."}'

# 3. Consulta lo que queda.
npx @rozoai/checkout x402 balance

Qué pasa en x402 pay

HTTP directo: dos llamadas

¿Sin shell? Usa la misma API directamente. Envía tu clave de agente como Authorization: Bearer ak_....

# Recarga: devuelve una dirección de depósito de un solo uso para la moneda elegida.
curl -s -X POST https://apiserver.mpprouter.dev/v1/x402/topup \
  -H 'authorization: Bearer ak_...' -H 'content-type: application/json' \
  -d '{"amount":"20","token":"USDT","chain":"900"}'

# Firma: envía el requisito que elegiste de la lista "accepts" del 402.
# Devuelve el valor de la cabecera PAYMENT-SIGNATURE. Reenvía tu solicitud con él.
curl -s -X POST https://apiserver.mpprouter.dev/v1/x402/sign \
  -H 'authorization: Bearer ak_...' -H 'content-type: application/json' \
  -d '{"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x...","maxTimeoutSeconds":60}],"budget":"0.05","idempotencyKey":"<uuid>"}'

POST /v1/x402/keys crea la clave de agente (se muestra una vez). GET /v1/x402/balance devuelve el saldo. Usa el mismo idempotencyKey en cada reintento de un mismo pago.

Con qué puedes recargar y con qué se paga

Dos tramos, separados a propósito: lo que envías a ROZO y lo que recibe el vendedor.

Tramo de recarga (tú a ROZO)

Tramo de pago (ROZO al vendedor x402)

Límites y tu clave

• Por pago: como máximo $5 por defecto. Por día: como máximo $100 por defecto. También puedes limitar una clave a una lista de direcciones payTo.
• Recarga mínima: $5. La recarga lleva una comisión del 1%; cada pago x402 posterior cuesta solo lo que pide el vendedor.
• Clave de agente: la primera recarga crea una clave que empieza por ak_. Se muestra una vez y la CLI la guarda en ~/.rozo-checkout/x402-key con permisos solo para el propietario. ROZO solo guarda su hash.
• La clave es dueña del saldo. No la pegues en prompts, logs ni tickets. Si la pierdes, crea una nueva y escríbenos para mover el saldo.

Preguntas frecuentes

¿Por qué tengo que recargar primero?

Un requisito de pago x402 vale entre uno y cinco minutos, y mover fondos entre redes tarda más. Pagar desde un saldo que ya está listo es la única forma de responder dentro de ese margen. Recargas pocas veces y en importes grandes; pagas a menudo y en importes pequeños.

¿Dónde está mi dinero?

En tu saldo x402 de ROZO. Los fondos están en wallets de ROZO, la de Base firma los pagos de tu clave, y el total de todos los saldos se concilia con esas wallets cada hora. ROZO nunca guarda las claves de tus propias wallets.

¿Cómo recupero mi saldo?

Los retiros todavía no son de autoservicio. Escribe a hi@rozo.ai con tu clave enmascarada (por ejemplo ak_...a1b2) y el importe, y te lo devolvemos en la red que elijas.

¿ROZO ve mi solicitud?

No. La solicitud de pago va de tu máquina al endpoint. ROZO solo ve el requisito de pago que se le pide firmar: a quién se paga, cuánto y en qué red.

¿En qué redes cobra el vendedor?

USDC en Base (eip155:8453), esquema x402 exact. El pago en Solana llegará más adelante. Si un endpoint solo acepta Solana, la CLI se detiene con X402_UNSUPPORTED y no se cobra nada.