Skip to main content

​
Introducció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.