Recibir Pix en custodia
Saldo en reales brasileños, subcuentas y retiros por Pix o en criptomonedas. Sin billetera fija.
LuniumPay / Guías de integración
Pix y criptomonedas en tu producto.
Empieza por el flujo.
Guías para equipos que integran pagos en billeteras, plataformas, marketplaces y sistemas de gestión. Elige cómo entra el dinero, dónde permanece el saldo y cómo recibe los fondos el destinatario.
¿Buscas una solución Pix para tu empresa?
Conoce la API Pix para recibir y enviar pagos o usa la guía de comparación de APIs Pix para evaluar proveedores. Después, elige a continuación el flujo que quieres probar.
¿Qué necesita hacer tu producto?
Recibir Pix y entregar criptomonedas
Solicitud de cobro, USDT o USDC, red de entrega y confirmación por webhook.
Recibir criptomonedas y pagar Pix
Vista previa, aceptación, depósito en la red correcta y conciliación del pago.
Pagar Pix usando el saldo
Payouts, débito, tarifas, consulta de estado y recuperación tras un fallo.
¿Custodia o entrega directa?
En custodia, el Pix se acredita en saldo BRL. La aplicación puede separar el saldo por cliente y solicitar retiros después. En la entrega directa, la solicitud de cobro ya define la criptomoneda, la red y la dirección del destinatario. Esta elección cambia los campos de la llamada y el evento que debe esperar tu aplicación.
No confundas el cobro del Pix con la entrega final de criptomonedas: confirma el estado de liquidación antes de marcar la entrega como completada.
Planifica la integración y registra lo que ya funciona
¿Estás comparando proveedores o empezando un proyecto? La guía de on-ramp y off-ramp Pix te ayuda a elegir entre entrega directa, custodia en reales brasileños y salida por Pix.
Descarga la lista de comprobación para tu equipo o IA: indica el flujo, las evidencias de prueba y los requisitos de la prueba piloto. No incluyas claves de API ni datos personales en el archivo.
De la elección a la primera prueba
Abre la demostración del flujo
En Integrar, elige custodia, Pix a criptomonedas, criptomonedas a Pix o payout. La demostración usa saldo ficticio y no exige un registro obligatorio.
Lleva el contrato a tu proyecto
Descarga el kit Node/Python o sigue la guía de integración con IA. La descripción de integración de la página incluye el flujo elegido y enlaces a la especificación actual.
Prueba también los casos de fallo
Valida la idempotencia, el vencimiento, el saldo insuficiente, las retenciones y el reenvío de webhooks usando los escenarios del sandbox.
Antes de mover dinero real
El sandbox valida el contrato y la lógica de la integración. Una prueba piloto de producción valida la liquidación real con credenciales, importes y destinatarios autorizados.
Webhooks e idempotencia
Gestiona los reenvíos, valida las firmas y recupera el estado después de un timeout.
Cómo evaluar una API de pagos
Compara el contrato, los límites, la retención, la conciliación y el tratamiento de fallos.
Migrar una integración existente
Planifica el adaptador, valida cada función y conserva la conciliación durante el cambio.
Qué permite probar el sandbox
Entiende el saldo ficticio, la confirmación de Pix, la simulación de entrega y los estados de error.
¿Qué documento usar en cada etapa?
| Etapa | Fuente | Qué comprobar |
|---|---|---|
| Planificar | Manual de la API | Campos, autenticación, estados y ejemplos. |
| Implementar con IA | Guía para agentes | Instrucciones, contrato y criterios de finalización. |
| Validar | Sandbox | Flujos y fallos con saldo ficticio. |
| Operar | Estado y manual | Disponibilidad, catálogo y conciliación. |
Prueba el flujo que quieres integrar.
Elige el recorrido y copia la descripción de integración a tu editor o agente de IA. El contexto te acompaña hasta la implementación.
Contenido técnico del equipo de LuniumPay · Revisado el . Las tarifas, los límites y las rutas de producción deben consultarse en la API.