API Pix para empresas y desarrolladores

Recibe y envía Pix
en tu sistema.

Crea solicitudes de cobro con código QR y Pix Copia y Pega, sigue los pagos mediante webhooks y automatiza los envíos de Pix desde el saldo disponible. Una API de orquestación para integrar en tu sitio, aplicación o plataforma.

Recibe reales brasileños sin registrar una billetera de criptomonedas. Sandbox con importes ficticios. Integración realizada por tu equipo o con ayuda de IA.

¿Qué parte de Pix necesitas automatizar?

01 / RECIBIR

Solicitud de cobro Pix por API

Genera una solicitud de cobro por pedido, muestra el QR y el código para copiar y pegar, y vincula el cobro al cliente en tu sistema. El importe liquidado se ingresa en custodia BRL según las tarifas y reglas de la cuenta.

Ver cobros y custodia →
02 / HACER SEGUIMIENTO

Confirmación por webhook

Actualiza los pedidos a partir de notificaciones firmadas. Consulta el estado mediante la API y sigue el cobro, la liquidación y la disponibilidad del saldo.

Ver confirmación y conciliación →
03 / PAGAR

Envío de Pix y payouts

Implementa retiros, pagos y transferencias usando el saldo disponible de la cuenta o de la subcuenta. Consulta las tarifas y sigue cada envío hasta el resultado final.

Ver pagos Pix por API →

Pix dentro del producto que ya estás construyendo.

SaaS y sistemas de gestión

Asocia las solicitudes de cobro a clientes y pedidos. Actualiza el sistema cuando se confirme el pago y conserva el historial para conciliar.

Sitios y aplicaciones

Ofrece Pix en tu propia interfaz. Tu backend crea la solicitud de cobro; tu cliente usa su aplicación bancaria para pagar el QR de producción.

Plataformas y marketplaces

Organiza los saldos por referencia de cliente e implementa transferencias autorizadas. Las reglas comerciales y la autorización de cada usuario quedan en tu sistema.

La integración usa llamadas de API en tu backend. Si necesitas un plugin listo para una plataforma específica, describe el entorno en el contacto de integración para comprobar la compatibilidad antes de contratar.

De la solicitud de cobro a la confirmación en tu sistema.

  1. Tu sistema crea el pedido. Guarda de forma persistente la referencia de la operación y envía el importe, la identificación del pagador y el destino de custodia.
  2. El cliente recibe la solicitud de cobro Pix. Muestra el código QR, el código para copiar y pegar, el importe y la validez devueltos. Generar una solicitud de cobro aún no significa haber recibido el pago.
  3. Sigue los eventos. Verifica la firma del webhook y consulta el estado de la operación para recuperar notificaciones perdidas o fuera de orden.
  4. Concilia y habilita la siguiente etapa. Comprueba la liquidación y el saldo disponible antes de un retiro o transferencia. Un importe recibido puede estar sujeto a retención.

Puedes operar cobros y retiros por Pix usando saldo BRL. La conversión a criptomonedas es una opción adicional para productos que necesitan esa salida.

Compara el coste completo y cuándo estará disponible el saldo.

Antes de contratar una API Pix, evalúa la tarifa de cobro, el coste de envío, el plazo de liberación, los límites por operación y pagador, el soporte y el tratamiento de fallos. Una tarifa aislada no indica el coste de toda tu operación.

Condiciones de tu operación

Las tarifas y reglas aplicables a la cuenta se pueden consultar mediante la API. Para analizar tu caso, indica el tipo de producto, el importe medio de compra, el volumen mensual estimado y si necesitas recibir, pagar o ambas cosas.

Hablar sobre volumen e integración →

Prueba antes de mover fondos

El sandbox permite validar el flujo, el vencimiento, la retención, los fallos y los webhooks con importes ficticios. Los precios, la liquidez y la disponibilidad de producción se comprueban en las respuestas reales de la API.

Entender las pruebas disponibles →

Consulta la guía para comparar APIs Pix y proveedores.

Empieza con tu equipo. O lleva el proyecto a tu IA.

La documentación pública y el kit Node.js/Python ayudan a tu desarrollador a implementar la primera solicitud de cobro y seguir el resultado. Un agente de código también puede seguir los contratos, implementar la integración y probar los escenarios. Elige la vía de registro adecuada para tu producto; Mesh no es obligatorio para usar la API.

Recomendamos Lunium Partners y un grupo del proyecto con @luniumb2b y @luniumb2c. Lunium o tu equipo pueden crear el grupo para hacer seguimiento de la integración y de los casos operativos.

Preguntas sobre la API Pix.

¿Necesito usar criptomonedas para recibir Pix?

No. En el flujo de custodia, la solicitud de cobro se liquida en saldo BRL y puedes solicitar un retiro por Pix. La conversión a criptomonedas solo forma parte del flujo cuando se elige; recibir en custodia no exige una billetera fija.

¿La API genera códigos QR y Pix Copia y Pega?

La creación de la solicitud de cobro devuelve el código para copiar y pegar y, cuando está disponible, la URL de la imagen del QR. Tu sistema debe mostrar los datos devueltos, el importe y la validez. El QR del sandbox es ficticio y no se debe pagar en un banco.

¿Cómo sabe mi sitio que el Pix se ha pagado?

Usa un receptor de webhooks firmados y consulta el estado mediante la API. Cobro, liquidación y saldo disponible son etapas distintas: confirma la etapa necesaria antes de habilitar un retiro o considerar la entrega completada.

¿Puedo enviar Pix a clientes y proveedores?

El flujo payout envía Pix usando el saldo BRL disponible de la cuenta o subcuenta. Antes de crear la operación debes comprobar la habilitación, las tarifas y los límites efectivos de tu clave.

¿Incluye Pix Automático y reparto automático?

Las funciones descritas en esta página son solicitudes de cobro Pix, custodia, consultas, webhooks y payout. No des por hecho que se admite Pix Automático para débitos recurrentes ni el reparto automático entre varios beneficiarios. Las subcuentas y las transferencias programadas por tu aplicación son funciones diferentes. Confirma los requisitos adicionales con el equipo.

¿Lunium es el banco que procesa el Pix?

LuniumPay proporciona la capa de orquestación e integración mediante la API. Las etapas financieras usan proveedores asociados según la ruta. La operación de LuniumPay está identificada como ZANQUETA INTERMED LTDA, CNPJ 68.538.127/0001-00.

¿Cuál es la mejor API Pix para mi proyecto?

Depende de los cobros, los pagos salientes, los costes, los límites y la integración necesaria. Compara la documentación y las pruebas prácticas antes de decidir. Nuestra guía presenta criterios y fuentes públicas de distintos proveedores.

Comparar APIs Pix →

Lleva tu flujo de Pix a LuniumPay.

Empieza por la demostración de cobros o cuéntanos qué necesita integrar tu empresa. Puedes explorar el sandbox antes de rellenar el formulario.

Veamos qué necesita tu empresa de Pix.

Cuéntanos si necesitas recibir Pix, enviar pagos o integrar ambos flujos. Indica el tipo de sistema, el volumen estimado y tu consulta principal. Nuestro equipo responderá al correo indicado.

¿Prefieres escribir directamente por correo? contato@luniumpay.com