Integra mediante ChatGPT y agentes

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.”

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.
Presenta el QR: la solicitud de cobro devuelve una imagen, PIX Copia y Pega y vencimiento. El pagador paga mediante la aplicación bancaria.
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 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 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.”

Indica el PIX: clave e importe en reales brasileños, o el PIX Copia y Pega completo de una solicitud de cobro.
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.
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.
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.
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 .

En los ajustes de ChatGPT, habilita Developer Mode cuando esté disponible.
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.
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.”
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.
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.