Integración de Lunium # Integra mediante ChatGPT y agentes ## 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 Partners](https://t.me/+FerOZMRRP_g5MDk5)[Cómo participar](/es/manual#lunium-partners) ## Operación y conciliación Configura la comisión, entiende cada tarifa, recupera el monitor y gestiona incidentes con el contrato vigente. [Tarifas y comisiones](/es/manual#comissoes)[Recuperar acceso](/es/manual#recuperar-acesso)[Resolver incidentes](/es/manual#incidentes) Revisión: 06/10/2026. Inicio guiado: https://luniumpay.com/integrar . Contrato legible por máquina: https://docs.luniumpay.com/integration.json . ## Cobra en PIX, recibe en USDT Pide a tu IA: **“Quiero cobrar R$ 100 mediante PIX y recibir USDT en mi billetera. Muestra la estimación neta, genera el QR y sigue el pago.”** 1. **Indica el pago:** importe en reales brasileños, documento de quien pagará y tu billetera con la red correcta. La IA consulta las tarifas, el mínimo y la estimación neta. 2. **Presenta el QR:** la solicitud de cobro devuelve una imagen, PIX Copia y Pega y vencimiento. El pagador paga mediante la aplicación bancaria. 3. **Sigue el resultado:** la IA informa del PIX recibido y del envío de USDT registrado, con enlace de la transacción cuando está disponible. La confirmación en la red es una etapa independiente. Para los cobros reales, crea tu acceso mediante [autoservicio](https://luniumpay.com/es/#chave-producao) y conéctalo en un host compatible con `https://api.luniumpay.com/mcp`, usando la clave en la configuración segura del host. No pegues claves en el chat. El conector público siguiente ofrece demostraciones; la vinculación de cuentas de producción mediante OAuth aún no está disponible. Las tarifas, mínimos y retenciones se indican antes de crear la solicitud de cobro. La cantidad de USDT es estimada hasta la conversión. El registro y la integración no dependen de una conversación comercial. El [contrato estructurado](/es/integration.json) incluye el procedimiento completo en `receive_pix_usdt_in_chat`. ## Paga PIX con cripto y recibe el comprobante Pide a tu IA: **“Quiero pagar R$ 100 a esta clave PIX usando mi cripto. Muestra la cotización y cómo enviarla; después, sigue el pago y entrega el comprobante.”** 1. **Indica el PIX:** clave e importe en reales brasileños, o el PIX Copia y Pega completo de una solicitud de cobro. 2. **Elige la moneda y la red:** la IA consulta las opciones disponibles y muestra la cantidad de cripto, el importe en reales brasileños, los costes y el vencimiento. Los pagos por Copia y Pega aceptan actualmente USDT/USDC en las rutas compatibles; los pagos por clave tienen otras opciones del catálogo. 3. **Revisa y obtén las instrucciones:** después de aceptar la cotización, recibe la dirección de depósito y el memo/tag cuando sea obligatorio. 4. **Envía la cripto:** usa la cantidad y la red indicadas, incluido el memo/tag, dentro del plazo devuelto. El seguimiento muestra el depósito, las confirmaciones, la conversión cuando es necesaria y el pago del PIX. 5. **Recibe el comprobante:** cuando el PIX esté pagado, la IA muestra el E2E y los enlaces disponibles del comprobante, PDF y verificación. Si el documento aún se está preparando, sigue acompañando el mismo pago. El plazo depende de la red y del procesamiento del PIX. Antes de enviar, comprueba los costes de la cotización; en Copia y Pega, el importe adicional de procesamiento ya está incluido en el total indicado. Usa siempre el código original de la solicitud de cobro: no sustituyas un PIX Copia y Pega por una transferencia a la clave extraída de él. Ante un retraso, revisión o devolución, sigue la orden original. No vuelvas a enviar por un timeout ni por la ausencia momentánea del comprobante. El acceso real usa el mismo MCP completo y la configuración segura descritos anteriormente; la conexión pública siguiente es de demostración. ## Conocer y probar dentro de ChatGPT Una cuenta/workspace elegible puede habilitar el modo de desarrollador y añadir una aplicación/plugin MCP remoto. La disponibilidad y los nombres de los menús dependen de la cuenta y de la política del workspace. Sigue las instrucciones oficiales: https://developers.openai.com/plugins/deploy/connect-chatgpt . 1. En los ajustes de ChatGPT, habilita Developer Mode cuando esté disponible. 2. Crea la conexión **Lunium — integración**, con URL `https://api.luniumpay.com/mcp/onboarding`. Elige sin autenticación para esta conexión pública. 3. Revisa las herramientas y añade la conexión a la conversación. Pide: “Planifica una integración Lunium para recibir PIX en custodia usando Node.js. Ejecuta una demostración de sandbox y prepara el código para mi proyecto.” 4. El agente consulta `lunium_plan_integration`, inicia `lunium_start_sandbox_demo` con un UUID, tu `email` (opcional en las herramientas MCP, pero muy recomendable: con él, LuniumPay envía a la persona la guía de integración —qué es LuniumPay, manual, diagrama de flujo y próximos pasos— una sola vez; sin él, crea la clave igualmente y recoge el correo después mediante `lunium_contact`) y `flow` igual a `custody`, `cashin`, `payout` o `cashout`, y sigue `lunium_get_sandbox_demo`. La simulación termina en `COMPLETED`; no se mueve dinero. 5. Continúa con el kit de código y la lista de preparación. Si quieres acompañamiento humano, proporciona el correo electrónico y autoriza `lunium_contact`. Este contacto es opcional. La conexión pública realiza planificación, consultas de catálogo, pruebas sintéticas y contacto con consentimiento. No vincula cuentas de producción. El OAuth de una cuenta Lunium para ChatGPT aún no está implementado; los requisitos están en https://developers.openai.com/plugins/build/auth . El MCP completo en `/mcp` también tiene herramientas de cuenta, para hosts que configuren `X-API-Key` de forma segura. No pegues claves de producción en el chat. La existencia de un endpoint MCP no implica la publicación automática en el directorio de aplicaciones de ChatGPT. Si la opción de conexión no aparece en tu cuenta, usa las instrucciones y el kit siguientes. ## Empezar con cualquier IA de programación Abre https://luniumpay.com/integrar , elige el flujo y el lenguaje y copia las instrucciones. Incluye el proyecto en el que quieres trabajar. Las instrucciones apuntan al contrato vigente y solicitan implementación, pruebas y una explicación de lo que aún debe validarse. Descarga https://docs.luniumpay.com/starter/lunium-starter.zip . Ejecuta `node sandbox.mjs all` (Node 20+) ou `python3 sandbox.py all` (Python 3.9+). No hay bibliotecas adicionales. Los scripts crean una clave de prueba en memoria (con el correo de quien hará las pruebas, en `LUNIUM_SANDBOX_EMAIL`), simulan el flujo elegido (o todos con `all`), consultan el estado y rechazan las claves de producción. Puedes reutilizar tu clave `lun_test_` mediante la variable de entorno `LUNIUM_API_KEY`. El archivo `AGENTS.md` del kit orienta a la IA en el repositorio. No sustituye a las instrucciones de tu proyecto. Código de prueba: https://docs.luniumpay.com/starter/sandbox.mjs y https://docs.luniumpay.com/starter/sandbox.py . ## Qué flujo implementar - **Recibir PIX en custodia:** `POST /cashin/charge` con `destino: "saldo"`. Crédito en BRL; no requiere billetera fija. El `payer_tax_number` es el documento del pagador real. `customer_ref` elige la subcuenta. - **Retirar cripto de la custodia:** consulta el disponible en `/saldo`, las rutas en `/cashin/catalog` y elige moneda, `chain`, dirección y memo cuando sea obligatorio. Envía `POST /saldo/sacar-cripto`. No prometas todas las monedas enumeradas: comprueba `entregavel` y los límites. - **PIX con entrega directa en cripto:** usa `destino: "cripto"`, catálogo de entrega y `POST /cashin/preview` antes de crear la solicitud de cobro. - **De cripto a PIX:** usa `/catalog`, `POST /cash-outs`, aceptación y seguimiento. Este flujo también está disponible en sandbox. - **Payout PIX:** confirma las capacidades en `/keys/me`, el saldo disponible y las tarifas en `/saldo`; crea en `POST /payouts` y sigue el ID devuelto. En cash-in y retiro en cripto, el campo de red es `chain`; en cash-out es `network`. En cash-in y payout, los importes en reales brasileños usan centavos enteros. En cash-out, `brl_amount` es una cadena decimal en reales brasileños, como `"100.00"`; las cantidades de cripto también usan cadenas decimales. Consulta el esquema de cada ruta en https://docs.luniumpay.com/openapi.json . ## Qué demuestra la prueba El sandbox cubre PIX de entrada, crédito de custodia, retiro y entrega de cripto, payout PIX, transferencia interna y cash-out. El QR no es bancario: el pago se confirma en `POST /sandbox/cashin/{cashin_id}/pay`. Todo es ficticio, sin llamadas a bancos, exchanges ni blockchain. Consulta https://docs.luniumpay.com/sandbox para ver escenarios de fallo, retención, saldo insuficiente, resultado incierto, webhooks firmados y diferencias con producción. La demostración pública usa datos sintéticos fijos. No recibe billeteras, PIX, importes ni claves de producción. El identificador de prueba caduca después de dos horas; el estado financiero ficticio persiste tras reiniciar; cash-out tiene una retención de dos horas. Reutiliza `request_id` en los reintentos y el `demo_id` para el seguimiento. Una prueba completada no certifica toda tu integración. ## Antes de operar con dinero real Lee https://docs.luniumpay.com/manual . Comprueba los permisos y límites de la clave, los mínimos y tarifas por ruta, los documentos y destinatarios reales, el saldo disponible y las retenciones. Implementa `external_id` persistente por intención, reintentos sin modificar la solicitud, verificación HMAC del cuerpo sin procesar del webhook, timestamp y deduplicación de eventos. Tras un timeout, consulta la operación original. Cash-in solo se completa con `status=paid` **y** `settlement_status=sent`; cash-out con `state=COMPLETED`; payout con `status=sent`. No trates `delayed` como un fallo. Guarda las claves y los secretos solo en el backend. Autoriza conscientemente la primera operación real del flujo elegido. ## 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](https://t.me/luniumb2b) y [@luniumb2c](https://t.me/luniumb2c), además de [@LuniumNotifyBot](https://t.me/LuniumNotifyBot). [Consulta la guía del grupo](/es/manual#telegram). Para hacer seguimiento, usa el monitor privado de `/keys/me` e implementa [webhooks, panel en directo y conciliación](/es/manual#monitor-ao-vivo). No compartas claves, secretos ni el monitor con personas no autorizadas.