Lunium. Documentación

Eres un agente. Esto es todo lo que necesitas.

Procedimiento autónomo: de sandbox a producción

Métodos, requisitos exactos, credenciales, webhooks y recuperación. Mesh tiene activación automática por política; el registro habitual permite custodia sin billetera fija.

Abrir el procedimiento completo · JSON · Markdown

Lunium Partners

Comunidad oficial de integradores. Sigue los avisos operativos, los mantenimientos, los cambios de la API y el intercambio entre socios. Se recomienda encarecidamente participar desde el inicio de la integración.

Unirse a Lunium PartnersCómo participar

Operación y conciliación

Configura la comisión, entiende cada tarifa, recupera el monitor y gestiona incidentes con el contrato vigente.

Tarifas y comisionesRecuperar accesoResolver incidentes

Lunium liquida entre PIX y stablecoins. Un agente descubre, integra, valida, entra en producción y realiza transacciones automáticamente, dentro del mandato del responsable y de las reglas de la API. Esta página es el recorrido completo.

empieza aquí

Una llamada, sin ninguna clave:

curl https://api.luniumpay.com/mesh

Responde quiénes somos, qué liquidamos, qué activos y redes admitimos, todos los endpoints, cómo obtener credenciales, cómo llegar a producción, los límites y los esquemas. — capacidades e — intenciones indexadas.

El recorrido, desde cero hasta la transacción real

  1. Descubrimiento. Empieza por el dominio: https://luniumpay.com responde en la cabecera Link dónde está el /.well-known/api-catalog (RFC 9727). Desde allí llegas al /mesh sin conocer ninguna ruta. Cómo funciona.
  2. Elige la capacidad según tu intención, no según nuestro vocabulario. Cada capacidad declara intent, input_assets, output_currencies y payment_rails. Filtra por atributo.
  3. Regístrate en POST /mesh/agents. Recibes agent_id y una credencial lun_test_… en la misma respuesta.
  4. Prueba el sandbox. No basta con tener la clave: crea y aceptación una orden. Es lo que garantiza que tu tratamiento de errores existe antes de operar con dinero.
  5. Valida en POST /mesh/agents/{id}/validate.
  6. Indica dónde recibir — /settlement.
  7. Define tu mandate — /mandate. Solo restringe tus propios límites, nunca los amplía. Por qué.
  8. Activa producción — /production-request. automático Ninguna persona decide. Si falta algo, recibes 422 con missing y next_actions, lo corriges y vuelves a intentarlo.
  9. Realiza transacciones. La credencial de producción es lun_live_….
  10. Incorpora a otro agente y recibe — del volumen que liquide. Cómo funciona la economía.

Qué hace Lunium

FlujoAPI
Pix → BRLPOST /cashin/charge · destino=saldo
BRL → criptoPOST /saldo/sacar-cripto
Pix → criptoPOST /cashin/charge · destino=cripto
Criptomonedas → PixPOST /cash-outs → accept
BRL → PixPOST /payouts
Una sola cosa, sin ninguna credencial: GET https://api.luniumpay.com/v1/verificar/{e2e} demuestra que un PIX se liquidó realmente, a partir del identificador del Banco Central. Sirve para comprobar un pago que no realizaste tú, de una contraparte en la que no tienes motivos para confiar.
MeshDescubrimientoCapacidadesIncorporaciónMandatosLiquidaciónProducciónRecomendaciónEconomíaSeguridadErroresEjemplos

Acompañamiento humano y en directo

Se recomienda encarecidamente un grupo con atención humana: Lunium o el socio pueden crear el grupo del proyecto y añadir @luniumb2b y @luniumb2c, además de @LuniumNotifyBot. Consulta la guía del grupo. Para hacer seguimiento, usa el monitor privado de /keys/me e implementa webhooks, panel en directo y conciliación. No compartas claves, secretos ni el monitor con personas no autorizadas.