Skip to main contentIntroducción
En el contexto del procesamiento de pagos, las facturas son el punto de partida para generar y gestionar cobros a tus clientes. Una factura en OnePay crea un Payment asociado que concentra toda la información operativa del cobro (monto, moneda, enlaces de pago, estado, canales permitidos), facilitando la conciliación y el seguimiento del ciclo de vida del pago.
Este documento ofrece una visión general de cómo interactúan las facturas con los cobros, cómo se puede dividir un pago entre múltiples destinatarios y cómo se dispersan los fondos a sus beneficiarios finales.
Cobros
La creación de una factura inicia un flujo de cobro. Al crearla, OnePay genera un Payment que:
- Contiene el monto, la referencia y los metadatos clave del cobro.
- Expone un enlace de pago (payment_link) y opciones de canal para que el cliente final complete el pago.
- Mantiene su estado a lo largo del proceso (por ejemplo, Pending, Approved, Cancelled), lo que permite consultar el progreso y tomar decisiones.
Las facturas pueden incluir datos del cliente (teléfono y correo) para habilitar notificaciones y experiencias de pago más fluidas.
Pagos divididos
Dependiendo de tu caso de uso, el pago originado por una factura puede requerir dividirse entre varios destinatarios (por ejemplo, marketplace, aliados o proveedores). OnePay soporta pagos divididos (splits) a través del Payment asociado. Esto permite:
- Definir múltiples receptores con montos o porcentajes específicos.
- Mantener trazabilidad de quién recibe qué parte del pago.
- Preparar la información necesaria para futuras dispersiones.
Nota: La configuración de splits se realiza en el ámbito del Payment. Desde la factura, puedes aprovechar estas capacidades mediante los endpoints del Payment si tu flujo lo requiere.
Dispersiones
Una vez cobrado el pago, los fondos pueden ser dispersados a sus beneficiarios finales según tus reglas de negocio. En OnePay, las dispersiones pueden realizarse hacia cuentas bancarias u otros destinos soportados. En términos generales:
- El Payment consolidado por la factura sirve como fuente de la información a dispersar.
- Puedes orquestar dispersiones totales o parciales, y programarlas según tus necesidades.
- Las dispersiones respetan los splits definidos, de modo que cada beneficiario reciba exactamente el valor que le corresponde.
Endpoints de facturas
Para operar con facturas desde tu integración, utiliza los siguientes endpoints:
- Crear factura: POST /invoices
- Listar facturas: GET /invoices
- Obtener factura: GET /invoices/
- Eliminar factura: DELETE /invoices/
Cada endpoint requiere autenticación Bearer. Consulta las páginas individuales para conocer parámetros, ejemplos de respuesta y posibles códigos de error. 
