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.
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
- Entra a Productos y abre el producto.
- Elige Embudo de venta.
- Activa el interruptor de cada pieza que quieras usar y llena sus campos.
- 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 }
}
}
availableesfalsesi el embudo no está activado para tu comercio.commissionstrae la comisión estimada de cada oferta:amount,feeMode,commission,min,maxybyRail. Si no se puede calcular, traeamountyunavailablecon 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.
| Campo | Tipo | Descripción |
|---|---|---|
bumpEnabled | boolean | Enciende el order bump. |
bumpProductId | uuid | null | Producto que se ofrece en la casilla. |
bumpAmount | number | null | Precio del bump. Con null se usa el precio del producto ofrecido. |
bumpHeadline | string | null | Título. Máximo 80 caracteres. |
bumpText | string | null | Texto. Máximo 300 caracteres. |
upsellEnabled | boolean | Enciende el upsell. |
upsellProductId | uuid | null | Producto del upsell. |
upsellAmount | number | null | Precio del upsell. |
upsellHeadline | string | null | Título. Máximo 80 caracteres. |
downsellEnabled | boolean | Enciende el downsell. |
downsellProductId | uuid | null | Producto del downsell. |
downsellAmount | number | null | Precio del downsell. |
downsellHeadline | string | null | Título. Máximo 80 caracteres. |
offerEnabled | boolean | Enciende la oferta con contador. |
offerAmount | number | null | Precio de la oferta. Debe ser menor que el precio del producto. |
offerEndsAt | string (ISO 8601) | null | Fecha y hora de fin. Debe ser futura mientras la oferta esté activa. |
showStock | boolean | Muestra «Quedan N». Solo con stock definido. |
testimonialsEnabled | boolean | Muestra las reseñas de compradores reales. |
recoveryEnabled | boolean | Reservado 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
| HTTP | Código | Causa |
|---|---|---|
| 403 | FUNNEL_NOT_ENABLED | El embudo no está activado para tu comercio (solo en PUT). |
| 403 | FEATURE_DISABLED | Los productos no están disponibles. |
| 404 | PRODUCT_NOT_FOUND | El producto no existe o no es de tu comercio. |
| 422 | FUNNEL_PRODUCT_NOT_OWNED | El producto ofrecido no es de tu comercio. |
| 422 | FUNNEL_CURRENCY_MISMATCH | El producto ofrecido tiene otra moneda. |
| 422 | FUNNEL_PRODUCT_IS_MAIN | El producto ofrecido es el producto principal. |
| 422 | FUNNEL_PRODUCT_NOT_AVAILABLE | El producto ofrecido no está visible. |
| 422 | FUNNEL_OFFER_INVALID | La oferta necesita un precio menor al del producto y una fecha futura. |
| 422 | FUNNEL_PIECE_INCOMPLETE | Una pieza está activa y no tiene producto. |
| 422 | FUNNEL_AMOUNT_INVALID | Un monto es menor que 1 o tiene más de 2 decimales. |
| 422 | FUNNEL_TEXT_TOO_LONG | Un título o texto supera el máximo de caracteres. |
| 422 | FUNNEL_PRODUCT_KIND_REQUIRED | El producto principal o el del bump no tiene tipo (físico o digital). |
| 422 | FUNNEL_DOWNSELL_REQUIRES_UPSELL | El 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.