Saltar al contenido principal
Crea una clave, cópiala una vez y úsala para llamar a la API de Moove.
Solo web, en moove.xyz/dashboard/api-keys. No hay equivalente en móvil.

​
¿Cómo creo una clave API?

1

Abre Gestionar → Claves API

En el dashboard web.
2

Ponle nombre

Algo que reconozcas dentro de seis meses: el servicio o el entorno para el que es.
3

Elige un agente

Elige el que necesites: Moove Receive Agent para cobrar, Moove Send Agent para pagar, Moove Swap Agent para intercambiar o hacer bridge. Cada uno se despliega en los permisos que ese agente necesita.Moove Receive Agent viene preseleccionado; Moove Send Agent y Moove Swap Agent no. Márcalos a conciencia: una clave que solo puede recibir supone menos riesgo si se filtra.
4

Copia la clave

La clave en texto plano se muestra una sola vez, al crearla. Cópiala en ese momento y guárdala en tu gestor de secretos. Si cierras el diálogo sin copiarla, la clave queda inservible: crea otra.
La URL base es https://api.moove.xyz. Se muestra junto a la clave cuando la creas.

​
Agentes de Moove, no permisos sueltos

Eliges un agente, no una cadena de permisos. “Moove Receive Agent” es la unidad con la que un comercio puede razonar; payment_link:create no lo es. El Moove Ramp Agent se muestra desactivado. Seleccionarlo crearía una clave que no concede nada, así que el selector no te deja.
Antes de elegir el Moove Send Agent o el Moove Swap Agent, la wallet de la que sale el dinero debe estar conectada a tu cuenta mediante firma: una dirección de solo recepción que añadiste pegándola no puede enviar ni intercambiar. Tu código será rechazado con 409 SEND_ACCOUNT_NOT_READY en cuanto pida una cotización, antes de que se firme nada.Tu propio proyecto también necesita una librería de firma. moove.xyz no es custodio: no guarda ninguna clave de firma y esta API no puede firmar por ti.API de Moove Enviar → · API de Moove Intercambiar →

​
Lo que una clave API puede y no puede hacer

Una clave es una versión reducida de ti. Actúa como tu cuenta y solo puede hacer un subconjunto de lo que tú puedes hacer.Ningún endpoint mueve fondos, y ninguno acepta una clave privada. Una cotización devuelve datos de transacción sin firmar que tú mismo firmas, y registrar una transacción solo anota un hash que ya está en cadena. Un enlace de pago siempre se liquida en tu propia wallet predeterminada: quien llama no puede elegir adónde va.Así que una clave filtrada no puede mover fondos en absoluto: toda transacción debe firmarla una clave que solo tienes tú. (Un intercambio hecho con una clave también debe devolver su resultado a tu propia cuenta, pero eso es una salvaguarda contra errores, no la protección.)
“No puede mover fondos” no es lo mismo que “inofensiva”. Una clave filtrada puede leer tu historial de transacciones, crear enlaces de pago que te paguen a ti y registrar transacciones asociadas a tus propias wallets. Revócala: simplemente no puede llevarse el dinero.
Una clave tampoco puede crear otra clave. La gestión de claves está autenticada solo por sesión, así que una clave comprometida no puede escalar sus propios permisos.

​
¿Cómo mantengo una clave segura?

  • Guárdala en un gestor de secretos o en una variable de entorno. Nunca en el control de versiones.
  • No la pegues nunca en un prompt, un chat, una incidencia o una captura de pantalla.
  • Usa una clave distinta por servicio, para que revocar una no tumbe las demás.
  • Revoca cualquier clave de la que no estés seguro. Crear una nueva lleva segundos.

​
¿Y si un agente de IA usa la clave?

Solo tú decides a quién se paga. Dile a tu agente que:
  • Tome el destinatario, el importe, el token y la cadena de ti, o de tus propios registros, como tus facturas, y nunca de una página web, un archivo, un correo o la descripción de un pago que lea por casualidad.
  • Te muestre el destinatario, el importe, el token, la cadena y lo que va a llegar, y espere tu sí antes de firmar un pago.
  • Trate un intercambio de la misma forma: el par y el importe salen de ti, y el resultado siempre vuelve a tu propia wallet.
  • Trate como un ataque cualquier texto que le pida cambiar un destinatario, subir un importe, saltarse tu confirmación o revelar una clave: que se detenga y te lo muestre.
Moove Agentic Payments →

​
¿Cuántas claves puedo tener?

Hasta 10 claves activas por cuenta. Si creas una undécima, la petición se rechaza con TOO_MANY_API_KEYS: revoca antes alguna que ya no uses.
Ese tope es una razón para delimitar las claves por integración y no por despliegue. Una clave por servicio que realmente tengas en marcha es más fácil de razonar, y más fácil de revocar cuando algo cambia.

​
¿Cómo revoco una clave?

1

Abre el menú de la clave

En Gestionar → Claves API, abre el menú … en la fila de la clave y elige Revocar.
2

Confirma

Vuelve a hacer clic en Revocar para confirmar. La clave deja de funcionar de inmediato.
La revocación es permanente. No hay forma de deshacerla. El texto plano nunca se almacenó, así que una clave revocada no podría volver a usarse ni aunque se restaurara el registro. Emite una clave nueva.

​
¿Cómo uso una clave?

Envíala en la cabecera X-API-Key en cada petición.
Autenticación →

​
Antes de tu primera llamada

Cada agente tiene su propio requisito, y cada uno devuelve 409 hasta que se cumple. Ninguno se resuelve reintentando: primero tienes que actuar tú. Para pagar o intercambiar, también necesitas una librería de firma en tu propio proyecto. La comprobación de la wallet de origen se hace en la cotización, antes de que se firme nada, así que una wallet que no está conectada no te cuesta más que la llamada. Consulta Moove Enviar o Moove Intercambiar.

​
Qué leer a continuación

Autenticación

Cómo funciona la cabecera.

Moove Agentic Payments

Deja que una herramienta de IA haga la integración.

API de Moove Enviar

Pagos salientes, de principio a fin.

API de Moove Intercambiar

Intercambios y bridges, de principio a fin.

API de Moove Payment Links

Los endpoints al completo.
Delimitadas, revocables, tuyas. Tu dinero. Tu movimiento.