Cómo integrar PIX → stablecoins en Lovable o Replit
lun_live_… se guarda en un secreto del backend. El frontend solo llama a tu función, recibe el PIX para copiar y pegar y sigue un estado sin datos sensibles.Arquitectura correcta
navegador
└─ POST /api/checkout-pix (sem chave Lunium)
└─ sua função de servidor
├─ lê LUNIUM_API_KEY do secret manager
├─ chama POST /cashin/preview
├─ chama POST /cashin/charge
└─ persiste external_id + cashin_id
Lunium ──webhook assinado──> sua função de webhook
└─ atualiza o pedido
Prompt listo para el agente
Adicione checkout PIX com liquidação em USDT/USDC usando https://api.luniumpay.com/openapi.json como contrato. Regras obrigatórias: 1. Toda chamada com X-API-Key deve acontecer no servidor. 2. Guarde LUNIUM_API_KEY somente no secret manager. 3. Nunca envie a chave ao browser, console, URL ou analytics. 4. Antes da cobrança, consulte /cashin/limits para o pagador. 5. Use external_id estável por pedido e persista antes da chamada. 6. Trate delayed como PIX pago e retido, não como falha. 7. Valide assinatura e timestamp do webhook antes de processar. 8. Faça o consumidor do webhook idempotente. 9. Use consulta de status apenas para reconciliação. 10. Mostre o diff e os testes; não use chave real nos testes.
El prompt no reemplaza la revisión del código generado. Verifica que ningún bundle del frontend, respuesta HTTP o log contenga la clave.
Pasos de implementación
Crea una función de servidor
Función Edge, acción de servidor o ruta de backend. Si el entorno solo ofrece frontend estático, no es suficiente para almacenar una clave financiera.
Registra el secreto
Usa el almacén de secretos del entorno. El nombre puede ser LUNIUM_API_KEY; el valor nunca entra en el repositorio.
Implementa la solicitud idempotente
Genera y guarda de forma persistente external_id en tu base de datos antes de llamar a la API. En caso de timeout, reutiliza el mismo valor.
Implementa el webhook
Recibe el cuerpo sin procesar, valida la firma y aplica una transición de estado solo una vez.
Prueba sin dinero y revisa producción
En cash-out, usa el sandbox para el ciclo completo. En cash-in, valida el contrato, el catálogo, los límites y la vista previa; después realiza el PIX real mínimo permitido con una clave de producción y concilia antes de aumentar el volumen.
Lista de comprobación de filtraciones
Bundle
Busca lun_live_ en los archivos generados. El resultado debe ser cero.
Red
El navegador nunca llama a Lunium usando tu clave; llama a tu backend.
Logs
Registra request_id e IDs de la operación, no cabeceras ni cuerpos con datos sensibles.
Git
Los secretos y archivos locales están excluidos del control de versiones; la búsqueda de secretos se ejecuta antes de publicar.
Tu agente puede empezar por el contrato actualizado
Abre la guía rápida, copia el prompt y pide que implemente primero el sandbox. Para revisar el diseño, envía solo el diff sin secretos.