Ofertas: order bump, upsell y downsell

Visión general

Una oferta es un precio reutilizable que registras una vez y reaprovechas en varias ventas. Hay tres tipos:

• Order bump: aparece en el checkout como un complemento rápido y, al aceptarse, entra como una línea extra en el cobro que se está creando.
• Upsell: oferta de un clic tras la compra, normalmente un artículo de mayor valor, que genera un nuevo cobro para el contacto.
• Downsell: también de un clic tras la compra, usada como alternativa más barata cuando el cliente rechaza el upsell — igualmente genera un nuevo cobro.

En todos los casos la oferta guarda nombre, importe, moneda y método; solo la vinculas a una venta o a un contacto en el momento adecuado.

Requisitos previos

• Una pasarela conectada y válida (consulta Conectar pasarela).
• Opcional: un producto del Catálogo vinculado a la oferta (catalog_product_id), para reaprovechar el registro del producto.
• Define en la oferta la conexión (pasarela) y el método (billing_type) que se usarán cuando se convierta en cobro — sobre todo para upsell y downsell.
• Para aceptar una oferta (upsell/downsell), el contacto necesita datos mínimos (nombre y, idealmente, correo/teléfono) para el pagador en la pasarela.

Cómo funciona

• Order bump en el checkout: la oferta se convierte en una línea de cobro (nombre, importe y moneda quedan "fotografiados" en ese momento). Suma al total agregando una nueva línea — nunca altera el importe de un cobro ya existente. La línea solo guarda la referencia de la oferta en sus metadatos.
• Upsell / downsell tras la compra: al aceptar la oferta para un contacto, la plataforma crea un nuevo cobro reaprovechando la conexión, el importe y los datos del pagador ya conocidos — sin reescribir nada. Ese cobro sigue el flujo normal (pasarela → webhook → tarjeta de pago en la conversación), igual que cualquier otro cobro.
• La oferta nunca se modifica al aceptarse: es una plantilla; cada aceptación crea un cobro nuevo e independiente.
• La aceptación poscompra solo funciona para una oferta activa y no archivada. Un order bump pertenece al checkout y esta acción lo rechaza. Repetir el mismo intento de red recupera el mismo cobro.

Paso a paso

1. En el área de Pagos, abre Ofertas y crea una nueva oferta.
2. Indica el nombre, elige el tipo (order bump, upsell o downsell), el importe y la moneda.
3. Define el método y la conexión (pasarela) que se usarán al generar el cobro.
4. (Opcional) Vincula un producto del catálogo y escribe una descripción.
5. Guarda. La oferta está disponible mientras esté activa.
6. Para aplicar un order bump, usa la oferta en el checkout: si el cliente la acepta, se convierte en una línea extra del cobro.
7. Para aceptar un upsell/downsell, una integración autorizada llama a la API de aceptación para el contacto, con empresa y conversación explícitas cuando corresponda. La operación genera un nuevo cobro; crear la oferta en el catálogo no ejecuta esa aceptación.
8. Para retirar una oferta, archívala — desaparece de las ofertas disponibles, pero el precio se conserva (nunca borramos un precio que un embudo activo pueda referenciar).

Configuración y opciones

Catálogo, aceptación y pagador son decisiones distintas

Crear o guardar una oferta solo registra una opción en el catálogo; no crea un cobro ni inicia una suscripción. La pantalla de Ofertas administra ese catálogo. Esta versión no tiene un botón de aceptación poscompra en esa pantalla.

Una integración autorizada puede aceptar un upsell/downsell mediante la API. La aceptación requiere el contacto responsable y puede indicar organization_id explícitamente para cobrar a una empresa vinculada a ese contacto; conversation_id conserva el contexto de la conversación cuando se indica. El registro fiscal de la empresa debe cumplir los requisitos de la pasarela y el método elegidos. Sin una elección explícita de empresa, no deduzcas el pagador del producto o negocio. El intento debe conservar su clave de idempotencia; aceptar es una operación financiera, no una consulta al catálogo.

Un order bump es solo una línea adicional en el checkout que se está componiendo. Guardar la oferta o añadir esa línea no emite un cobro por sí solo. El endpoint de aceptación poscompra rechaza order bump; no lo uses para iniciar un cobro implícito. Emitir el cobro y cualquier envío en la conversación siguen siendo acciones propias del flujo de cobro.

Campos de una oferta:

Casos de uso

• Aumentar el ticket con un order bump en el checkout ("agrega la garantía extendida por $19,90").
• Ofrecer un upsell justo después de la compra ("lleva la versión Pro con un clic").
• Recuperar la venta con un downsell cuando el cliente rechaza el upsell más caro.
• Reutilizar la misma oferta en varias conversaciones y checkouts, sin volver a crear el precio.

Consejos, límites y buenas prácticas

• El order bump no altera un cobro ya creado — solo agrega una línea al total en el momento del checkout.
• Aceptar un upsell/downsell siempre crea un cobro nuevo e independiente; la oferta original permanece intacta.
• Las ofertas se archivan, no se borran — así no se rompe ningún embudo o historial que dependa de ese precio.
• Define conexión y método en la oferta de upsell/downsell: sin ellos, la aceptación no puede generar el cobro correctamente.
• Los importes están en unidades mayores ($49,90 = 49.90); el total del checkout es la suma de las líneas — nunca dividas por 100.

Solución de problemas

• La oferta no aparece: comprueba que esté activa y no archivada (las ofertas inactivas o archivadas no se presentan).
• La aceptación falló: verifica que el contacto tenga los datos mínimos y que la conexión (pasarela) de la oferta sea válida — la aceptación crea un cobro real y necesita esos datos.
• El importe del order bump salió mal: recuerda que agrega una línea al total; no reemplaza ni reduce las demás líneas.
• No puedo eliminar una oferta: las ofertas se archivan (reversible), no se eliminan — usa archivar.

Ver también

• Crear un cobro y enviarlo en la conversación
• Conectar pasarela: Asaas y Mercado Pago
• Catálogo nativo de productos y servicios