Agentes que mueven dinero
En pruebas. Tu agente compra en la tienda, paga facturas y opera en el P2P con tu saldo, dentro de los topes que tú fijas.
Un token de agente puede llevar permisos para gastar tu saldo. Cada permiso se elige al crear el token y siempre va con topes.
Todavía no está disponible para todos. Lo estamos probando con un grupo pequeño de cuentas y lo iremos abriendo poco a poco, una función a la vez. Si en Ajustes → Agentes IA no ves «Dejar que mueva dinero», tu cuenta aún no lo tiene; no hay lista de espera ni hace falta pedirlo.
Lo que sigue describe cómo funciona en la versión de pruebas. Los topes y la lista de herramientas pueden cambiar antes de abrirse para todos.
Permisos
| Permiso | Qué puede hacer el agente |
|---|---|
mcp:store | Comprar recargas a Cuba, recargas internacionales, gift cards y eSIM |
mcp:pay | Pagar facturas de comercios que cobran con QvaPay |
mcp:p2p:buy | Publicar ofertas de compra, tomar ofertas de venta y marcar pagado |
mcp:p2p:sell | Publicar ofertas de venta con un método de pago que ya tengas guardado |
Estos permisos solo funcionan en el servidor MCP. Ninguna ruta de la API los acepta.
Lo que un agente nunca puede hacer
- Liberar el saldo de una venta P2P. Eso lo confirmas tú cuando te llega el pago.
- Transferir a otro usuario o retirar.
- Ver el código de una gift card o el QR de una eSIM. Te llegan a ti, en la app y por correo.
- Leer o escribir en el chat de un trato, abrir o resolver disputas y calificar.
- Tomar una oferta de compra: ahí los datos de cobro se dan por el chat.
- Firmar una declaración. Si una operación la exige, el agente recibe un rechazo y la haces tú en la web o en la app.
Crea el token
- Activa la verificación en dos pasos con una app de autenticación, si aún no la tienes.
- Abre Ajustes → Agentes IA y marca lo que el agente puede hacer.
- Fija los topes.
- Escribe el código de 6 dígitos de tu app de autenticación. El PIN por correo no sirve aquí.
El token caduca a los 30 días como máximo. Para cambiar los topes, crea otro token y revoca el anterior.
Topes
| Tope | Por defecto | Máximo que puedes fijar |
|---|---|---|
| Por operación | $25 | $100 |
| Por día | $100 | $500 |
| Gift cards por día | $50 | $100 |
| Tratos P2P abiertos a la vez | 3 | 10 |
- El tope por día cuenta las últimas 24 horas y suma lo de todos tus agentes. Crear más tokens no lo multiplica.
- Cuenta el precio de cada compra, el importe de cada factura y el saldo que bloquea una oferta de venta. Ese saldo sigue contando aunque canceles la oferta el mismo día.
- Comprar en el P2P no bloquea saldo: cuenta como trato abierto, no en dólares.
- Lo que pasa de un tope se rechaza sin cobrar nada. Lo puedes hacer tú en la app.
Clave de idempotencia
Toda herramienta que mueve dinero pide idempotency_key: entre 8 y 64 letras, números, - o _. Si el agente repite la llamada con la misma clave, no se cobra dos veces y recibe el resultado de la primera.
Si el desenlace de una operación no se pudo confirmar, el agente recibe OUTCOME_UNKNOWN. No debe reintentar con otra clave: primero se comprueba en qvapay_my_purchases o qvapay_p2p_my. Mientras tanto, esa operación sigue contando contra el tope del día.
Avisos y «No fui yo»
Cada operación de un agente te llega por Telegram y por notificación, con el importe y el nombre del token. El botón No fui yo congela la cuenta y borra todos tus tokens, también los de agente.
Las compras y los pagos no se pueden deshacer.
Herramientas
Las compras aceptan preview: true, que devuelve el precio final sin cobrar.
Tienda (mcp:store)
| Herramienta | Qué hace | Parámetros |
|---|---|---|
qvapay_store_cuba_packages | Paquetes de recarga a Cuba con su precio | — |
qvapay_store_catalog | Marcas y ofertas por país | category (topup, giftcard o esim), country, brand, page |
qvapay_buy_cuba_topup | Compra una recarga a Cuba | package_id, phone_number, recipient_name, preview, idempotency_key |
qvapay_buy_topup | Compra una recarga internacional | offer_id, country, phone_number, amount, preview, idempotency_key |
qvapay_buy_giftcard | Compra una gift card | offer_id, country, amount, preview, idempotency_key |
qvapay_buy_esim | Compra una eSIM | offer_id, country, preview, idempotency_key |
qvapay_my_purchases | Tus compras con su estado de entrega | page |
Facturas (mcp:pay)
| Herramienta | Qué hace | Parámetros |
|---|---|---|
qvapay_invoice | Importe, estado y vencimiento de una factura | uuid |
qvapay_pay_invoice | Paga una factura pendiente | uuid, idempotency_key |
P2P (mcp:p2p:buy, mcp:p2p:sell)
| Herramienta | Qué hace | Permiso | Parámetros |
|---|---|---|---|
qvapay_p2p_my | Tus ofertas y órdenes abiertas | cualquiera | — |
qvapay_p2p_offer | Detalle de una oferta. Si eres parte, incluye los datos de pago | cualquiera | uuid |
qvapay_payment_methods | Tus métodos de pago guardados: id, moneda y nombre | vender | coin |
qvapay_p2p_create | Publica una oferta de monto fijo | el de type | type, coin, amount_usd, receive, payment_method_id, idempotency_key |
qvapay_p2p_apply | Toma una oferta de venta | comprar | uuid, amount_usd, idempotency_key |
qvapay_p2p_paid | Marca pagado con la referencia de la transferencia | comprar | uuid, order, reference |
qvapay_p2p_cancel | Cancela una oferta o un trato tuyo | cualquiera | uuid, order |
qvapay_p2p_pause | Pausa o reanuda una oferta tuya | cualquiera | uuid, paused |
Una oferta de venta usa los datos de un método de pago guardado. El agente elige cuál por su id; no ve los números ni los escribe.
Datos escritos por otras personas
Los campos que empiezan por untrusted_ los escribe un tercero: el nombre de la app de un comercio o los datos de pago de la contraparte en un trato. El agente los recibe en una línea y recortados, para mostrártelos. No son instrucciones.