Documentación · Embudos y pagos

Cobrar en un embudo con Lava

Vende directamente dentro del chat: el comprador pulsa un botón, paga y el bot entrega el acceso por su cuenta. Paso a paso, incluidos los errores con los que ya nos hemos topado.

Actualizado: 26 de septiembre de 2026

Tu embudo puede cobrar: una persona llega al paso Pago, recibe un botón, paga y el bot entrega el acceso y continúa el embudo por su cuenta. No tienes que hacer nada, ni de día ni de noche.

Los pagos pasan por Lava.top, un servicio de pagos que trabaja con particulares y autónomos y acepta tarjetas y SBP (el sistema ruso de transferencias bancarias instantáneas).

💡 El dinero te llega directamente a ti. Tienes tu propia cuenta de Lava y tu propio contrato con ellos. Craft nunca retiene tu dinero ni se lleva una parte de tus ventas: solo creamos la factura y recibimos la notificación del pago.

Cómo funciona#

  1. Una persona avanza por el embudo y llega al paso Pago.
  2. El bot crea una factura personal en tu cuenta de Lava y envía un botón de pago; en Telegram, dos a la vez: ⚡️ Pagar por SBP y 💳 Pagar con tarjeta.
  3. La persona paga en la página de Lava.
  4. Lava nos avisa, el bot reconoce al comprador y continúa el embudo por la flecha que sale del paso Pago. Ahí entregas el acceso: un enlace a un canal, una invitación a un chat, un archivo.

Lo único que haces es configurarlo una vez. Después el embudo funciona solo.


Qué necesitarás#

  • Una cuenta en lava.top con un método de cobro confirmado.
  • Un embudo ya montado en Craft (Telegram o Instagram).
  • 15 minutos.

⚠️ Telegram es la opción fiable. En Instagram, el acceso solo se puede entregar si la persona te escribió en las últimas 24 horas: es una regla de Meta y no se puede esquivar. Como pagar puede tardar fácilmente más de un día, pasa a la gente de Instagram a Telegram y vende ahí.


Paso 1. Crea un producto en Lava#

En tu panel de Lava: Crear → Producto digital.

Rellena:

  • Descripción: qué compra la persona.
  • «Después del pago» (la parte de pago): pon aquí los enlaces a tu canal o chat. Lava también se los envía por email al comprador. Es tu red de seguridad: aunque le pase algo al bot, el comprador recibe el acceso igualmente.
  • Precio: puedes ponerlo en varias monedas a la vez.

Después publica el producto.

🔴 Un borrador no cuenta. Un producto no publicado no se ve a través de la API: simplemente no podemos emitir una factura para él, y parecerá que «la clave está mal». Asegúrate de que el producto está publicado.

Ambos campos —la descripción y la parte de pago— son obligatorios: sin ellos el producto no se guarda.

Quién fija el precio: Lava o el embudo#

El producto tiene un interruptor «Precio por solicitud vía API». Decide de dónde sale el importe de la factura, así que elige a conciencia.

Interruptor desactivado (por defecto) Interruptor activado
El precio lo fija Lava: lo que escribiste en el producto el embudo: el campo «Precio» del paso Pago
Para cambiar el precio edítalo en Lava edítalo en el embudo
Varios precios (rebajas, subida de precio) necesita un segundo producto un embudo, un producto
Producto en el escaparate de Lava se vende directamente solo se vende a través del embudo

Un precio que nunca cambia → déjalo desactivado, es más sencillo. ¿Planeas un temporizador de «el precio sube en 24 horas», rebajas o precios distintos por rama? → actívalo: consulta El embudo fija el precio.

🔴 Si vas a activarlo, consigue primero el offerId (paso 2) y después activa el interruptor. Una vez activado, el producto desaparece de la lista que devuelve Lava y ya no queda de dónde leer el offerId.


Paso 2. Consigue el offerId#

Una factura necesita el offerId, que NO es el número que ves en la dirección del producto.

🔴 El error más habitual. La barra de direcciones (app.lava.top/products/XXXX) muestra el id del producto. No funcionará. El offerId está dentro del producto y no se muestra en el panel. Si pegas el equivocado, el pago falla con «producto no encontrado».

Dos formas de conseguirlo:

La fácil: envíanos el enlace del producto y te lo buscamos.

Por tu cuenta (si te manejas con la línea de comandos), con tu clave de Lava:

curl -s "https://gate.lava.top/api/v2/products?showAllSubscriptionPeriods=true" \
  -H "X-Api-Key: YOUR_LAVA_KEY"

Busca tu producto en la respuesta: el valor que necesitas está en offers → id. Tiene este aspecto: 8665127d-....

💡 Cómo confirmar que el offerId es tuyo. El offerId de otra persona con tu clave no funciona: Lava responde que solo puedes vender tus propios productos. Es una forma práctica de comprobar que el dinero llegará a la cuenta correcta.

🔴 Consigue el offerId ANTES de activar «Precio por solicitud vía API». Con ese interruptor activado, el producto desaparece de la lista: la petición devuelve cero productos y parece una clave equivocada o un producto sin publicar. Guarda antes el offerId en algún sitio.


Paso 3. Conecta Lava en Craft#

En Craft: Ajustes → «Pagos en embudos (Lava)». Pega tu clave API de Lava (en Lava: Integraciones → Public API) y pulsa «Conectar». Craft comprueba la clave con Lava al momento: una clave equivocada se detecta aquí, no en tu primera venta.

🔴 Nunca reenvíes la clave a nadie. Permite emitir facturas en tu nombre. Pégala solo en esta página; no debe acabar en chats, en una conversación con una IA ni en capturas de pantalla. Si se filtra, elimínala en Lava, crea una nueva y vuelve a pegarla.

Una vez conectado, la misma página muestra la URL del webhook y el secreto que necesitas para el siguiente paso, además de un botón «Productos y sus ids» que lista tus productos y el offerId exacto que usa el paso Pago.


Paso 4. Configura el webhook#

El webhook es la forma en que Lava nos cuenta qué pasó con un pago: se completó, falló, se reembolsó. Sin él, el bot nunca se entera del pago y no da acceso.

En Lava: Integraciones → Public API → Add Webhook.

Campo Qué introducir
URL la dirección que aparece en la página de ajustes de Craft (https://craftopen.space/api/payments/webhook)
Eventos Marca los cuatro: pago completado, pago fallido, reembolso completado, contracargo iniciado
Autenticación Clave API de tu servicio
Clave API el secreto de la página de ajustes de Craft: hay un botón Copiar al lado

🔴 Marca también «pago fallido». Sin él, el bot nunca se entera de que a alguien le rechazaron la tarjeta: se queda en la página de error de Lava y tú nunca sabes que perdiste un comprador. Si configuraste el webhook antes de septiembre de 2026, ábrelo y comprueba los cuatro eventos.

🔴 El campo «Clave API» NO es tu clave de Lava. La etiqueta confunde. Es una contraseña que Lava usa para identificarse ante nosotros, para que sepamos que la notificación es auténtica. Craft te la da en la página de ajustes. Tu clave de Lava no va aquí y no es seguro ponerla.

Si pulsas «Nuevo secreto» en Craft, pon el nuevo secreto en el webhook de Lava enseguida: si no, las notificaciones de Lava dejan de superar la comprobación y el acceso tras el pago ya no se concede.


Paso 5. Monta el paso Pago#

En el constructor de embudos, añade un paso Pago y rellena:

  • Producto de Lava (offerId): el del paso 2.
  • Precio (para mostrar) y Moneda: solo afectan al texto del mensaje; Lava cobra el precio del propio producto.
  • Mensaje con el botón de pago: el texto de tu oferta; los botones aparecen debajo.
  • Texto del botón: se usa cuando solo hay un método de pago.
  • Variable del email: dónde se guarda el email del comprador.

🔴 Pide el email ANTES del paso de pago. Lava no emite una factura sin el email del comprador. Pon un paso Pregunta antes de Pago —«¿A qué email te enviamos el acceso?»— y guarda la respuesta en una variable (email por defecto). Sin él, el paso de pago simplemente no se activa.

Cómo pedirlo para que la gente no se vaya. «Te enviaremos un recibo» se lee como algo opcional: el comprador piensa «no necesito recibo» y simplemente no responde. Es una pérdida cara: ya había aceptado pagar. No digas «sin él no podemos seguir»; di qué pasa cuando lo envíe:

Queda un paso. Envíame tu email: lo usaré para tu pedido y te responderé enseguida con el botón de pago. El recibo también irá ahí. Y el acceso al curso te lo envío aquí, en este chat, justo después del pago.

Y pon a ese paso Pregunta un tiempo de espera con un recordatorio: si no, quien se distraiga desaparece sin más.

La flecha que sale del paso Pago es por donde continúa el embudo tras un pago completado. Es el paso en el que entregas el acceso: el enlace al canal privado, la invitación al chat, el archivo.

Métodos de pago#

En Telegram el comprador recibe dos botones: «⚡️ Pagar por SBP» y «💳 Pagar con tarjeta (tarjetas rusas)». Convierte mejor: la gente paga con lo que está acostumbrada.

  • Moneda distinta del rublo → solo tarjeta (SBP funciona en rublos).
  • Si uno de los métodos no está activado en tu cuenta de Lava, los demás botones llegan igualmente: el embudo no se rompe.

Las tarjetas extranjeras tienen su propio botón. «💳 Pagar con tarjeta (tarjetas rusas)» emite una factura en rublos, y no acepta tarjetas extranjeras: la página de pago se queda colgada y el cargo nunca llega al banco (confirmado con un pago real). Si algunos de tus compradores están en el extranjero, rellena «Precio para tarjetas extranjeras» en el paso Pago, por ejemplo $49. Aparece un tercer botón, «🌍 Pagar con tarjeta extranjera»: una factura en dólares o euros que acepta tarjetas de cualquier país.

  • Funciona con «El embudo fija el precio» marcado. Si el precio lo tiene el producto de Lava, el producto necesita un precio en esa moneda.
  • Elige un número redondo cercano al precio en rublos, por ejemplo 3490 ₽ → $49.
  • Por ahora solo en Telegram.
  • Apple Pay. Bajo el campo del precio hay una casilla, «Botón “🍎 Apple Pay con tarjeta extranjera”»: un botón más al mismo precio extranjero. La página de tarjeta extranjera no ofrece Apple Pay por sí sola, así que tiene su propio botón. Funciona en iPhone y Mac con una tarjeta extranjera en Wallet: las tarjetas rusas no se pueden añadir a Apple Pay, y Lava no lo acepta en rublos.
  • PayPal. Otra casilla, «Botón “🅿️ Pagar con PayPal”»: una factura al mismo precio extranjero para quienes no tienen una tarjeta adecuada. PayPal tiene que estar activado en tu cuenta de Lava; si no lo está, Lava lo rechaza y el comprador simplemente no verá este botón (los demás se mantienen).
  • Página de pago en inglés. Los botones extranjeros (tarjeta, Apple Pay, PayPal) abren la página de Lava y los emails de pago en inglés, ya que los usan los compradores del extranjero. Los botones en rublos siguen en ruso.
  • La confirmación tarda más. Un pago en rublos llega al bot en un par de segundos; uno extranjero a veces tarda 5–10 minutos: la página de pago devuelve al comprador directamente al bot, y el acceso llega cuando el banco liquida el cargo. Para que el comprador no se asuste ni pague dos veces, dilo en el texto del paso Pago, por ejemplo: «A veces el banco tarda 5–10 minutos en confirmar un pago: tu acceso llegará aquí solo igualmente, no hace falta volver a pagar».

En Instagram llega un solo botón de pago: tarjeta. Una razón más para pasar a los compradores a Telegram si vendes en Rusia.

🔴 No compartas el enlace directo al producto de Lava. Una compra hecha fuera del embudo no queda vinculada a una persona concreta: el bot no sabrá a quién entregar y la entrega automática no ocurrirá. Usa solo el botón del paso Pago.

Cuando alguien no paga#

El punto más caro de un embudo es la persona que abrió la página de pago y la cerró. Para que no se quede en silencio, el paso Pago tiene un campo «Seguimiento si no paga»: cuánto esperar el pago antes de enviarla por una rama aparte.

Rellénalo y el paso tiene una segunda salida, «No pagó». Adonde lleve esa flecha es adonde va el embudo si el pago no llega nunca.

Qué escribir en ese mensaje: normalmente la persona no pagó no porque cambiara de idea, sino porque su banco rechazó el cargo o el enlace se abrió en el navegador equivocado. Ofrece el otro método de pago (tarjeta en lugar de SBP o al revés) y tu contacto personal. Y añade un botón que vuelva al paso Pago: emite una factura nueva.

Una espera razonable es de 10–20 minutos: la gente o paga enseguida o ya ha pasado a otra cosa.

Si dejas el campo vacío, no hay rama: quien no paga ya no oye nada más.

Cuando el banco rechaza el pago#

Es otro caso: la persona quería pagar, pero la tarjeta no pasó: fondos insuficientes, el banco la bloqueó, el código no se confirmó. Aquí el bot actúa solo, no hay nada que configurar:

  1. Le dice a la persona por qué falló, con palabras sencillas, y le propone otro método: tarjeta en lugar de SBP, u otra tarjeta.
  2. Envía al momento botones de pago nuevos en el mismo paso, al mismo precio.
  3. Te avisa a ti: quién, cuánto, qué método y qué dijo el banco. Si no paga pronto, escríbele tú: esta persona quería comprar.

Si alguien probó SBP y luego pagó con tarjeta, no recibirá un mensaje de «no se completó». Dos fallos seguidos producen un mensaje, no dos.

Tras pagar o fallar, Lava devuelve a la persona al chat con el bot en lugar de dejarla en su propia página.

⚠️ Las notificaciones de pagos fallidos y reembolsos te llegan por Telegram si hay una cuenta de Telegram vinculada a tu cuenta de Craft. Si no la hay, recibimos la notificación y te la hacemos llegar. Vincularla es más fiable: te enteras al momento.

Lo mismo se aplica al paso «Pregunta» con el que pides el email: tiene un tiempo de espera y una salida «Sin respuesta». Sin ella, quien empieza la compra y se va en el campo del email también desaparece sin más. Pon 5 minutos y un recordatorio: «Sigo esperando tu email».


El embudo fija el precio (rebajas y temporizadores)#

Normalmente el precio está en el producto de Lava. Entonces «el precio sube en 24 horas» o «un descuento para esta rama» necesita un segundo producto, y a partir de ahí estás haciendo malabares con dos productos y dos offerId.

Hay un segundo modo: el embudo fija el importe de la factura. Un producto de Lava sirve para cualquier precio, y las subidas de precio y las rebajas se montan como ramas del embudo.

Cómo activarlo:

  1. En Lava, activa «Precio por solicitud vía API» en el producto (a estas alturas ya deberías tener el offerId: consulta el aviso del paso 2).
  2. En el paso Pago, marca «Este embudo fija el precio».
  3. El importe sale del campo «Precio» de ese paso. ¿Necesitas un segundo precio? Añade un segundo paso Pago en otra rama con otro precio.

Qué consigues: el precio del mensaje y el de la factura son ahora el mismo número del mismo campo: no pueden desajustarse. Un temporizador de «la oferta termina en», precios distintos por palabra clave, un visitante que vuelve y ve el nuevo precio: todo son ramas de un mismo embudo.

✅ Comprobado con pagos reales. Un embudo, un producto: la primera rama emitió una factura de 3490 ₽, la segunda de 4990 ₽, y la página de Lava mostró exactamente nuestro importe. USD y EUR también funcionan.

Qué saber de antemano:

🔴 El importe pasa a ser tu responsabilidad. Mientras el precio lo tenía Lava, no había nada que equivocar. Ahora una errata en el campo «Precio» es un cargo real. La combinación peligrosa es «importe todavía en rublos, moneda cambiada»: 3490 ₽ se convierten en $3490. Nos protegemos contra esto: si la moneda no es el rublo y el importe supera 1000, no se crea ninguna factura y recibes un aviso en tu bot. Revisar el par moneda/importe sigue siendo cosa tuya.

⚠️ El producto desaparece del escaparate de Lava: ya no se puede comprar directamente, solo a través del embudo. Si también vendías desde el escaparate, este modo no es para ti.

⚠️ El mínimo en rublos es 50 ₽. Lava rechaza cualquier importe menor («el importe es demasiado pequeño»). Tenlo en cuenta para los pagos de prueba.

⚠️ Por ahora solo en embudos de Telegram. En Instagram el precio sigue en el producto de Lava.


Cómo probarlo#

Primero las comprobaciones más baratas.

Sin gastar dinero:

  1. Pasa por tu propio embudo hasta el paso Pago y espera a los botones. Si aparecen, tu clave funciona, el producto está publicado y el offerId es correcto.
  2. Pulsa el botón y mira la página: ¿hay opción de método, el importe correcto, el nombre correcto del producto? No pagues: crear una factura por sí solo no mueve dinero.
  3. Comprueba que el embudo pide un email antes del pago y lo recuerda.

Con dinero (la comprobación final, una vez):

Lava no tiene modo de prueba: es su respuesta oficial. Así que la única forma de comprobar toda la cadena es un pago real por un importe pequeño.

  1. Pon temporalmente un precio pequeño (en el producto de Lava, o en el campo «Precio» del paso Pago si el precio lo fija el embudo).
  2. Págalo tú, una vez por método si vendes con tarjeta y con SBP.
  3. Confirma que el acceso llega al bot automáticamente.
  4. Restablece el precio real de inmediato.

🔴 Mientras un precio de prueba está activo, cualquiera puede comprar a ese precio. El producto está publicado y lo ve todo el mundo. Vuelve a poner el precio real enseguida, no «luego».

💡 Sobre la comisión. Lava se queda una comisión de cada pago: consulta la cifra exacta en tu panel y tu plan. En nuestra prueba se quedó aproximadamente un 8 % de un pago pequeño.

Probar el embudo entero#

Si tu embudo tiene seguimientos con temporizadores y más de un precio, probarlo «tal cual» lleva un día. La forma rápida:

  1. Guarda antes tus ajustes reales: apunta el retraso de cada paso antes de cambiar nada, o no podrás restablecer los tiempos exactamente.
  2. Pon todos los retrasos en 5 segundos y los precios en importes pequeños y distintos (por ejemplo 50 ₽ y 55 ₽), para que el importe te diga qué rama se activó.
  3. Recorre el embudo desde otra cuenta que nunca haya pasado por él: alguien que ya pasó cae a mitad del embudo, no al principio.
  4. Recórrelo dos veces: una sin pulsar nada (verás toda la cadena de seguimientos) y otra pulsando (verás el camino corto).
  5. Paga ambas ramas con los importes pequeños y confirma que el acceso llega solo.
  6. Restablece los retrasos y precios reales.

💡 Si durante tu prueba un mensaje llega con un minuto o dos de retraso, lo más probable es que el servicio se estuviera actualizando en ese momento. No se pierde nada, la cola se pone al día. No te apresures a arreglar un embudo que funciona.


Pagaron, pero no recibieron acceso#

Comprueba en este orden: nueve de cada diez veces es una de las dos primeras.

  1. ¿Está configurado el webhook en Lava, está el secreto correcto en el campo «Clave API» y están marcados los cuatro eventos (paso 4)? Sin webhook, Lava nunca nos avisó del pago, así que el bot no pudo reaccionar.
  2. Instagram y la regla de 24 horas. Si el pago se hizo más de un día después del último mensaje de la persona, Meta no deja que el bot le escriba.
  3. ¿Compró con el botón del embudo y no con un enlace directo al producto (ver el aviso de arriba)?
  4. ¿Llegó el email al paso de pago? Una variable de email vacía significa que no hay factura.

¿Sigues atascado? Escríbenos por Telegram con la hora del pago y el email del comprador. Revisaremos qué llegó a nuestro lado y, si hace falta, entregaremos el acceso a mano: el comprador lo recibe en el bot exactamente como con un pago normal.


Errores habituales#

Síntoma Causa
Los botones de pago no llegan nunca El offerId está vacío o no se pidió el email antes del paso de pago
El bot dice «Lava no acepta este email» Es el email de tu propia cuenta de Lava: no puedes comprar tu propio producto con él
A alguien le rechazaron la tarjeta y no te enteraste «Pago fallido» no está marcado en el webhook, o no hay Telegram vinculado a tu cuenta de Craft
«Producto no encontrado» Pegaste el id del producto de la barra de direcciones en lugar del offerId
«No vemos» un producto que creaste Es un borrador sin publicar, o «Precio por solicitud vía API» está activado (entonces no debería verse)
Factura por un importe equivocado El precio lo fija el embudo y el campo «Precio» tiene una errata
No hay factura y sí un aviso sobre el importe Moneda distinta del rublo con un importe del tamaño de uno en rublos: detuvimos el cargo
«El importe es demasiado pequeño» Lava no acepta menos de 50 ₽
El pago se completó, pero no hay acceso El webhook no está configurado o tiene el secreto equivocado
Alguien compró y el bot no hizo nada La compra vino de un enlace directo al producto, sin pasar por el embudo
El acceso nunca llegó en Instagram Pasaron más de 24 horas desde el último mensaje de la persona

Todavía no disponible#

Somos claros con los límites, para que no haya sorpresas:

  • Retirada automática del acceso al reembolsar. Te avisamos al momento de un reembolso o una disputa bancaria, pero sacar a la persona del canal o chat es cosa tuya.
  • Suscripciones y pagos recurrentes. Por ahora solo compras puntuales.
  • Los precios fijados por el embudo y la elección del método de pago son solo para Telegram. En Instagram el precio está en el producto de Lava y hay un solo botón.
  • Conectar las claves por tu cuenta. Por ahora se hace a través de nosotros y lleva minutos.

¿Necesitas algo de esta lista? Dínoslo. Construimos lo que la gente pide de verdad.

¿No encontraste la respuesta?Escríbenos por Telegram o a [email protected]: respondemos y ampliamos el artículo.
Escribir por Telegram