Skip to Content
QvaPay API
Agentes IA (MCP)

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

PermisoQué puede hacer el agente
mcp:storeComprar recargas a Cuba, recargas internacionales, gift cards y eSIM
mcp:payPagar facturas de comercios que cobran con QvaPay
mcp:p2p:buyPublicar ofertas de compra, tomar ofertas de venta y marcar pagado
mcp:p2p:sellPublicar 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

  1. Activa la verificación en dos pasos con una app de autenticación, si aún no la tienes.
  2. Abre Ajustes → Agentes IA y marca lo que el agente puede hacer.
  3. Fija los topes.
  4. 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

TopePor defectoMá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 vez310
  • 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)

HerramientaQué haceParámetros
qvapay_store_cuba_packagesPaquetes de recarga a Cuba con su precio—
qvapay_store_catalogMarcas y ofertas por paíscategory (topup, giftcard o esim), country, brand, page
qvapay_buy_cuba_topupCompra una recarga a Cubapackage_id, phone_number, recipient_name, preview, idempotency_key
qvapay_buy_topupCompra una recarga internacionaloffer_id, country, phone_number, amount, preview, idempotency_key
qvapay_buy_giftcardCompra una gift cardoffer_id, country, amount, preview, idempotency_key
qvapay_buy_esimCompra una eSIMoffer_id, country, preview, idempotency_key
qvapay_my_purchasesTus compras con su estado de entregapage

Facturas (mcp:pay)

HerramientaQué haceParámetros
qvapay_invoiceImporte, estado y vencimiento de una facturauuid
qvapay_pay_invoicePaga una factura pendienteuuid, idempotency_key

P2P (mcp:p2p:buy, mcp:p2p:sell)

HerramientaQué hacePermisoParámetros
qvapay_p2p_myTus ofertas y órdenes abiertascualquiera—
qvapay_p2p_offerDetalle de una oferta. Si eres parte, incluye los datos de pagocualquierauuid
qvapay_payment_methodsTus métodos de pago guardados: id, moneda y nombrevendercoin
qvapay_p2p_createPublica una oferta de monto fijoel de typetype, coin, amount_usd, receive, payment_method_id, idempotency_key
qvapay_p2p_applyToma una oferta de ventacompraruuid, amount_usd, idempotency_key
qvapay_p2p_paidMarca pagado con la referencia de la transferenciacompraruuid, order, reference
qvapay_p2p_cancelCancela una oferta o un trato tuyocualquierauuid, order
qvapay_p2p_pausePausa o reanuda una oferta tuyacualquierauuid, 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.