# Lista de comprobación de integración Pix y cripto — LuniumPay

Revisado el 18/09/2026. Documento de trabajo para desarrolladores y agentes de IA.
Completa con evidencias de prueba. No incluyas claves, tokens, CPFs ni datos bancarios
ni datos de clientes en este archivo. Usa variables de entorno e identificadores de prueba.

## 1. Define el producto antes de escribir código

- Nombre del proyecto:
- Responsable técnico:
- Flujo: [ ] Pix → custodia BRL [ ] Pix → cripto [ ] Cripto → Pix [ ] Payout Pix
- Quién recibe el saldo o el pago:
- Custodia de la cuenta principal o subcuenta por cliente:
- Activo/red previstos (confirmar en el catálogo):
- Criterio de finalización visible para el usuario:

Recibir Pix en custodia significa un crédito en BRL. No muestres ese crédito como
USDT recibido. Para la entrega directa de cripto, distingue entre Pix pagado y liquidación
completada. Para payout, consulta el estado final antes de anunciar que el pago está realizado.

## 2. Usa las fuentes actuales

- Manual: https://docs.luniumpay.com/es/manual
- Contrato: https://docs.luniumpay.com/es/openapi.json
- Sandbox: https://docs.luniumpay.com/es/sandbox
- Integración con IA: https://docs.luniumpay.com/es/integrar-com-ia
- Demostración: https://luniumpay.com/es/integrar
- Estado: https://docs.luniumpay.com/es/status

- [ ] Confirmar los endpoints, la autenticación, los campos y los estados en el contrato actual.
- [ ] Consultar los límites y las tarifas de la clave en GET /keys/me.
- [ ] Consultar el catálogo correcto: GET /cashin/catalog para la entrega de cripto;
      GET /catalog para la entrada de cripto seguida de Pix.
- [ ] Usar la vista previa para validar el importe mínimo de la ruta; no fijar importes en el código.
- [ ] Tratar el memo/tag cuando sea obligatorio y mostrar el activo y la red al depositante.

## 3. Criterios de aceptación en sandbox

| Caso | Evidencia esperada | Resultado / referencia de prueba |
|---|---|---|
| Flujo principal | La operación llega al estado final documentado | |
| Importe mínimo | Se acepta el importe anunciado; por debajo hay un error legible | |
| Saldo insuficiente | Se rechaza el retiro/payout sin saldo negativo | |
| Idempotencia | El mismo external_id y los mismos datos no duplican la operación | |
| Conflicto de idempotencia | Se rechaza el mismo external_id con datos distintos | |
| Timeout | La aplicación consulta la operación antes de volver a intentarlo | |
| Caducidad | La operación caducada no se muestra como pagada | |
| Retención / retraso | La interfaz distingue el saldo total del disponible | |
| Fallo / reversión | El estado y los movimientos siguen siendo conciliables | |
| Webhook | La firma y el timestamp se validan conforme al manual | |
| Reentrega | El mismo evento no duplica el crédito ni la entrega | |
| Conciliación | La consulta recupera el estado cuando no llega un evento | |

La disponibilidad de cada escenario depende del flujo. Usa los controles documentados
en sandbox; no presupongas que todos los endpoints tienen los mismos parámetros de simulación.
El sandbox usa importes ficticios y no acredita la liquidación en producción.

## 4. Preparación del piloto de producción

- [ ] Confirmar la elegibilidad, las credenciales y las condiciones con el equipo LuniumPay.
- [ ] Mantener los secretos en el backend; ninguna clave de producción en HTML ni en la aplicación cliente.
- [ ] Confirmar el webhook HTTPS y el tratamiento de eventos duplicados.
- [ ] Volver a consultar las tarifas, mínimos, rutas, retenciones y saldo disponible.
- [ ] Definir un importe pequeño autorizado, el destinatario correcto y el límite de exposición.
- [ ] Seguir la operación de extremo a extremo y registrar la conciliación.
- [ ] Definir el criterio de pausa y el responsable de investigar discrepancias.

## 5. Instrucciones para tu IA de desarrollo

Lee las fuentes actuales antes de implementar. Trabaja primero en sandbox.
Implementa solo el flujo elegido en este documento. No inventes endpoints,
campos, estados ni una confirmación de pago. No uses dinero real ni
credenciales de producción sin autorización específica. Para cada criterio de aceptación,
registra la prueba realizada, el resultado y lo que aún falta. Distingue la simulación
completada con éxito de liquidación real. No publiques datos personales ni secretos en las evidencias.

## 6. Envía contexto útil para la integración

Indica el flujo, el lenguaje/framework, el activo/red previstos, el volumen estimado
(si lo conoces) y la duda técnica. Ante un fallo, conserva request_id y external_id,
pero nunca envíes tu clave de API.

Empezar: https://luniumpay.com/es/integrar
Contacto: contato@luniumpay.com