Términos de relevancia

Aquí encontrarás una explicación más detallada de los conceptos relacionados a cobros que te ayudarán a comprender mejor la documentación.

Estados de cobros

¿Editable?¿Pagable?

Estado	Descripción	¿Editable?	¿Pagable?
ACCEPTED	El comercio confirmó manualmente la recepción del dinero en físico. Se pueden conciliar para pago posterior.
BLOCKED	El cobro fue bloqueado por los controles de seguridad debido a actividad sospechosa y no puede continuar su procesamiento.
CANCELED	El comercio canceló el cobro antes de que fuera pagado. No es posible reactivar.
CHARGEBACK	La transacción se encuentra en proceso de contracargo o disputa iniciada por el titular del medio de pago.
CREATED	El cobro fue creado y está disponible para pago, pero las notificaciones automáticas permanecen desactivadas.
CREDIT	El cobro será gestionado mediante una línea de crédito o acuerdo comercial con el comercio, sin requerir un pago inmediato.
EXTERNAL	El pago fue realizado por un canal directo y registrado en Trazo para efectos de conciliación y trazabilidad.
FAILED	El intento de pago no pudo completarse debido a un error, cancelación o interrupción durante el proceso.
OVERDUE	La fecha límite del cobro expiró sin registrar un pago.
PENDING	El cobro está activo y disponible para pago, con las notificaciones automáticas habilitadas.
PROCESSING	Existe un intento de pago en curso y la entidad financiera aún no ha emitido un resultado definitivo.
REFUND_PENDING	Se inició un proceso de reembolso y está pendiente de aprobación o ejecución.
REFUND_SUCCESS	El reembolso fue procesado exitosamente y los fondos fueron devueltos al cliente.
RET_PENDING	Se registró una solicitud de devolución y está pendiente de ser procesada.
RET_REVIEW	La devolución requiere una validación manual antes de ser aprobada o rechazada.
RET_SUCCESS	La devolución fue procesada y registrada exitosamente.
REVIEW	El cobrador confirmó la recepción del dinero en efectivo, pero está pendiente de legalización o consignación.
SCHEDULED	El cobro fue programado para activarse automáticamente en una fecha futura.
SUCCESS	El pago fue procesado y confirmado exitosamente.

---

Canales de distribución

Cada solicitud de cobro puede ser distribuida a través de tres canales de comunicación independientes según el flujo del comercio:

• Cobrar por link de pago Genera una URL única y segura que puede compartirse a través de cualquier plataforma. El cliente final visualiza e interactúa con el checkout desde el navegador de cualquier dispositivo. Canal: LINK

• Cobrar por WhatsApp Envía una notificación directamente a la cuenta de WhatsApp del usuario. Permite al cliente completar el pago de forma ágil desde el chat o redirigiendo a su navegador móvil. Canal: WHATSAPP

• Cobrar por correo Envía un correo electrónico estructurado con los detalles del cobro y un botón de pago interactivo que lleva al checkout. El usuario deberá completar el pago por medio del navegador de cualquier dispositivo. Canal: EMAIL

---

Integración Contable

Sincroniza en tiempo real los cobros procesados en Trazo con tu plataforma de contabilidad. Para habilitar esta automatización, primero debes configurar las variables de integración en el panel de tu negocio y, posteriormente, incluir el objeto invoice dentro del payload de la solicitud de cobro utilizando uno de los siguientes métodos:

• Vinculación de factura Asocia el recaudo exitoso a una factura preexistente y genera automáticamente su respectivo recibo de caja. Tipo: LINK

• Vinculación de cliente Genera un recibo de caja directamente a favor del saldo del cliente, sin asignarlo a una factura específica. Tipo: BALANCE

• Crear nueva factura Emite una nueva factura con el desglose de ítems enviado y genera su recibo de caja correspondiente al confirmarse el pago. Tipo: CREATE

Actualmente se cuenta con los siguientes software habilitados para integración:

Software	Estado
Alegra	Disponible
Odoo	En desarrollo
SAP Business One (B1)	Disponible
SAP S/4HANA	Validación requerida
Siigo	Disponible

---

Recargos y pagos anticipados

Configura reglas automáticas sobre tus cobros antes o después de la fecha límite establecida para incentivar el recaudo operativo.

• Recargos Aplica incrementos económicos automáticos sobre el valor base si la transacción se efectúa después de la fecha límite. Es posible parametrizar incrementos fijos por periodos de tiempo o fechas específicas. late_fees

• Pagos anticipados Genera descuentos automáticos sobre el monto total si el cobro se liquida de forma anticipada antes de la fecha límite configurada. advance_payment

Programa flujos periódicos de notificaciones (vía Email o WhatsApp) para alertar proactivamente al cliente sobre la proximidad de un vencimiento o la vigencia de un descuento por pago anticipado. Puede generar costos operativos adicionales según los canales de distribución seleccionados.

---

Cuentas administradas

La API de Trazo permite la creación y gestión de cuentas administradas (conoce más en la sección Cuentas Administradas). Al procesar transacciones en nombre de estas cuentas, puedes aplicar esquemas de monetización enviando parámetros especiales en la petición para realizar cobros específicos por cada transacción exitosa. Puedes determinar un monto fijo con custom_saas_fixed o un porcentaje variable con custom_saas_variable.