En esta página

Embudo de venta del link de producto

Vende más de una vez a cada comprador desde el link de producto (pay.iionpay.com/s/<slug>). Elige qué piezas usas en cada producto. Cada pieza tiene su propio interruptor.

Disponibilidad
El embudo se activa por comercio. Si tu comercio aún no lo tiene, el panel y la API lo indican y tus links siguen funcionando igual que hoy.

Las cuatro piezas

Order bump

Una casilla en el link de producto que agrega un segundo producto al mismo cobro.

  • La casilla llega sin marcar. El comprador decide si la marca.
  • Aparece solo en el producto principal.
  • El producto del bump es de tu comercio, está visible, tiene la misma moneda y no es el producto principal.
  • El producto principal y el del bump deben tener el tipo definido: físico o digital. Sin tipo en alguno de los dos, no se puede guardar el bump.
  • El comprador paga una sola vez. Tú recibes las dos líneas en la misma orden.
  • Si usas un cupón, el cupón descuenta solo el producto principal.

Upsell y downsell

Una oferta que el comprador ve después de que su pago se aprueba.

  • Upsell: una oferta adicional. Si el comprador la acepta, se crea una orden nueva con sus datos ya llenos. El comprador elige el medio de pago y paga otra vez.
  • Downsell: una segunda oferta, más económica. Solo aparece si el comprador rechaza el upsell. Para usarlo, activa también el upsell.
  • Cada orden nueva cobra su propia comisión. El panel muestra la comisión estimada de cada oferta antes de que la actives.
  • Si el comprador hace doble clic, se crea una sola orden.

Urgencia y prueba social

Datos reales del producto. iion pay los calcula en el servidor y nunca los reinicia por visitante.

  • Oferta con contador: un precio especial hasta una fecha y hora reales. Al llegar la fecha, el precio vuelve al normal y el contador desaparece.
  • «Quedan N»: se muestra solo si el producto tiene stock definido.
  • Ventas: cuenta las órdenes completadas del producto.
  • Reseñas: solo de compradores con una orden completada. Tú puedes ocultar una reseña. Nadie puede editarla.

Recuperación por correo

Un recordatorio por correo al comprador que dejó su contacto y no pagó.

  • Solo se escribe a compradores que dieron su consentimiento de forma expresa.
  • El comprador puede darse de baja desde el mismo correo.
  • Aún no está disponible. Esta pieza llegará en una fase posterior.

Cómo se configura en el panel

  1. Entra a Productos y abre el producto.
  2. Elige Embudo de venta.
  3. Activa el interruptor de cada pieza que quieras usar y llena sus campos.
  4. Guarda. Los cambios se ven en el link de producto al recargar.

El precio de una oferta lo fija el servidor. El comprador nunca envía montos.

API del comercio

Estos dos endpoints leen y guardan el embudo de un producto. Son los mismos que usa el panel. Requieren la sesión del comercio con el permiso collect:read (lectura) o collect:create (guardado). No se llaman con las llaves X-Api-Key y X-Api-Secret del API de cobros.

Leer el embudo

GET /api/v1/business/collect/products/:id/funnel

Si el producto no tiene embudo, la respuesta trae todo apagado. Respuesta:

{
  "success": true,
  "data": {
    "productId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "available": true,
    "config": {
      "bumpEnabled": false,
      "bumpProductId": null,
      "bumpAmount": null,
      "bumpHeadline": null,
      "bumpText": null,
      "upsellEnabled": false,
      "upsellProductId": null,
      "upsellAmount": null,
      "upsellHeadline": null,
      "downsellEnabled": false,
      "downsellProductId": null,
      "downsellAmount": null,
      "downsellHeadline": null,
      "offerEnabled": false,
      "offerAmount": null,
      "offerEndsAt": null,
      "showStock": false,
      "testimonialsEnabled": false,
      "recoveryEnabled": false
    },
    "commissions": { "bump": null, "upsell": null, "downsell": null, "offer": null }
  }
}
  • available es false si el embudo no está activado para tu comercio.
  • commissions trae la comisión estimada de cada oferta: amount, feeMode, commission, min, max y byRail. Si no se puede calcular, trae amount y unavailable con el código del motivo.

Guardar el embudo

PUT /api/v1/business/collect/products/:id/funnel
Content-Type: application/json

{
  "bumpEnabled": true,
  "bumpProductId": "0b9d0f6e-5a3c-4c8e-9a53-6f1d2c7e1a10",
  "bumpAmount": 9900,
  "bumpHeadline": "Agrega la guía de regalo",
  "bumpText": "Llévala hoy con tu pedido."
}

El guardado mezcla con lo que ya existe. Un campo ausente conserva su valor. Un campo con null se borra. La respuesta tiene la misma forma que el GET.

CampoTipoDescripción
bumpEnabledbooleanEnciende el order bump.
bumpProductIduuid | nullProducto que se ofrece en la casilla.
bumpAmountnumber | nullPrecio del bump. Con null se usa el precio del producto ofrecido.
bumpHeadlinestring | nullTítulo. Máximo 80 caracteres.
bumpTextstring | nullTexto. Máximo 300 caracteres.
upsellEnabledbooleanEnciende el upsell.
upsellProductIduuid | nullProducto del upsell.
upsellAmountnumber | nullPrecio del upsell.
upsellHeadlinestring | nullTítulo. Máximo 80 caracteres.
downsellEnabledbooleanEnciende el downsell.
downsellProductIduuid | nullProducto del downsell.
downsellAmountnumber | nullPrecio del downsell.
downsellHeadlinestring | nullTítulo. Máximo 80 caracteres.
offerEnabledbooleanEnciende la oferta con contador.
offerAmountnumber | nullPrecio de la oferta. Debe ser menor que el precio del producto.
offerEndsAtstring (ISO 8601) | nullFecha y hora de fin. Debe ser futura mientras la oferta esté activa.
showStockbooleanMuestra «Quedan N». Solo con stock definido.
testimonialsEnabledbooleanMuestra las reseñas de compradores reales.
recoveryEnabledbooleanReservado para la recuperación por correo (aún no disponible).

Los montos (bumpAmount, upsellAmount, downsellAmount y offerAmount) deben ser mayores o iguales que 1 y tener máximo 2 decimales.

Errores

HTTPCódigoCausa
403FUNNEL_NOT_ENABLEDEl embudo no está activado para tu comercio (solo en PUT).
403FEATURE_DISABLEDLos productos no están disponibles.
404PRODUCT_NOT_FOUNDEl producto no existe o no es de tu comercio.
422FUNNEL_PRODUCT_NOT_OWNEDEl producto ofrecido no es de tu comercio.
422FUNNEL_CURRENCY_MISMATCHEl producto ofrecido tiene otra moneda.
422FUNNEL_PRODUCT_IS_MAINEl producto ofrecido es el producto principal.
422FUNNEL_PRODUCT_NOT_AVAILABLEEl producto ofrecido no está visible.
422FUNNEL_OFFER_INVALIDLa oferta necesita un precio menor al del producto y una fecha futura.
422FUNNEL_PIECE_INCOMPLETEUna pieza está activa y no tiene producto.
422FUNNEL_AMOUNT_INVALIDUn monto es menor que 1 o tiene más de 2 decimales.
422FUNNEL_TEXT_TOO_LONGUn título o texto supera el máximo de caracteres.
422FUNNEL_PRODUCT_KIND_REQUIREDEl producto principal o el del bump no tiene tipo (físico o digital).
422FUNNEL_DOWNSELL_REQUIRES_UPSELLEl downsell está activo y el upsell no. El downsell solo se ofrece después de un upsell rechazado.

Desde un agente (MCP)

Los agentes conectados al MCP de iion pay usan las herramientas product_funnel_get y product_funnel_set. Tienen los mismos campos y los mismos errores.