Moove API
Una llamada. Cobro íntegro.
Crea un enlace de pago desde tu código. Tu cliente paga con cualquier token y tú recibes el importe íntegro en el tuyo.
De la clave al primer pago.
Crea una clave API
En Moove Business, crea una clave para el Moove Receive Agent. Solo se muestra una vez, así que guárdala directamente en tu entorno.Crea un enlace de pago
Un solo POST devuelve una URL de pago. Tu cliente paga ahí, con cualquier token y en cualquier cadena.Entérate cuando se pague
Registra un endpoint HTTPS y Moove le enviará un evento firmado en cuanto se pague un enlace.
API pequeña. Garantías sólidas.
Entra cualquier token, sale el tuyo
Tus clientes pagan con lo que tienen, en más de 30 redes blockchain. Cada pago se liquida en tu billetera, en el token y la cadena que elegiste.Un contrato sobre el que construir
Versionada en la ruta, solo con cambios aditivos en v1 y con un esquema OpenAPI siempre actualizado.Límites claros, errores claros
Límites por clave y por IP, un simple 429 y un único formato de error con códigos estables.La API en sí no tiene coste.
Sin suscripción ni cargo por llamada. Si un cliente paga con otro token o en otra cadena, cubre el 0,02%, así que recibes el importe íntegro.- Acceso a la API
- Gratis
- Mismo token, misma red
- Gratis
- Entre tokens o redes
- 0,02%
Moove frente a hacerlo tú mismo.
| Moove frente a hacerlo tú mismo. | Moove | Desarrollo propio |
|---|---|---|
| Cadenas compatibles | Moove: Más de 30, desde un solo endpoint | Desarrollo propio: Una integración por cadena |
| Conversión a tu token | Moove: Incluida en cada pago | Desarrollo propio: Tu propio enrutamiento de swaps y bridges |
| Saber que llegó un pago | Moove: Webhooks firmados y un endpoint de listado | Desarrollo propio: Listeners propios para cada cadena |
| Página de pago | Moove: Un enlace alojado, listo para compartir | Desarrollo propio: Diseñada, desarrollada y alojada por ti |
| Si se filtra una clave | Moove: Solo puede solicitar pagos para ti | Desarrollo propio: Todo lo que haya en la hot wallet |
Preguntas frecuentes.
¿Cómo obtengo una clave API?
Inicia sesión en la consola de Moove Business y abre Claves API. Ponle nombre a la clave y elige el Moove Receive Agent, que da permiso para crear y consultar enlaces de pago. La clave completa se muestra una sola vez, al crearla, y nunca más, así que guárdala en un gestor de secretos. No existe ningún endpoint que cree claves, así que una clave nunca puede emitir otra.
¿Adónde va el dinero cuando paga un cliente?
A la billetera predeterminada del propietario de la clave, en la cadena y el token de liquidación de esa billetera. Quien hace la llamada no puede indicar otro destino. Por eso la cuenta necesita un Moove handle reservado y una billetera predeterminada con token de liquidación antes de la primera llamada; si falta alguno de los dos, crear un enlace devuelve un 409 que indica que la cuenta no está lista para recibir pagos.
¿Hay una API de pagos salientes?
Todavía no. La API recibe pagos; no los envía. Para pagar hoy a proveedores o contratistas, usa Enviar en la consola de Moove Business. Ya se ha anunciado un Moove Send Agent, que aparecerá en la documentación cuando se lance.
¿Cómo funcionan los webhooks de Moove?
Registra hasta cinco endpoints HTTPS en la consola. Cada uno recibe dos eventos: uno cuando se liquida un pago de un enlace y otro cuando un enlace se completa. Los envíos se firman con HMAC-SHA256 mediante un secreto que se muestra una sola vez. La entrega es «al menos una vez», así que elimina duplicados por el id del evento. Una entrega fallida se reintenta hasta seis veces.
¿Hay límites de frecuencia?
Sí. Las solicitudes se limitan por clave API y por IP de origen, lo que se alcance primero, y superar el límite devuelve un 429. Aplica un backoff exponencial con algo de jitter en lugar de reintentar de inmediato, porque las solicitudes rechazadas también cuentan. Usa webhooks para conocer el estado de los pagos en vez de consultar un enlace una y otra vez, y planifica según el límite por IP si varias integraciones comparten un mismo host.
¿Cómo se versiona la API?
En la ruta. Hoy hay una versión pública, v1. Los cambios dentro de una versión solo añaden: nuevos endpoints, nuevos campos opcionales, nuevos campos de respuesta. Todo lo que pueda romper un cliente, como eliminar un campo o cambiar un tipo, se publica como una nueva versión en la ruta. Diseña tu cliente para ignorar los campos desconocidos y para decidir según los códigos de error, nunca según los mensajes.
