CreateYourVPN Academy
Guías

Aceptar pagos con lava.top

Guía paso a paso: conecta lava.top con CreateYourVPN para que tus clientes recarguen su saldo en tu escaparate. Clave API, webhook, importes de recarga y recarga automática.

lava.top acepta tarjetas, SBP y PayPal en rublos, dólares y euros. Tus clientes lo usan para recargar su saldo en el área personal de tu escaparate, y con ese saldo compran los planes: no hace falta conceder el acceso a mano.

lava.top trabaja con importes fijos: el cliente elige uno de los importes de recarga que configures, y cada importe tiene su propia oferta con el mismo precio. El cliente no puede introducir un importe propio. Si quieres aceptar cualquier importe, conecta también PayHot.

El dinero va a tu propia cuenta de lava.top. CreateYourVPN no es un intermediario en los pagos y no cobra comisión por tus ventas.

Aceptar pagos está disponible en el plan de pago Max: con él tu escaparate empieza a vender y el saldo de los clientes se activa solo. Sobre los precios de la plataforma, mira la lección de facturación.

Qué necesitas

  • una cuenta en lava.top (una cuenta de autor, es decir, la que vende);
  • 10–15 minutos para la configuración inicial;
  • una cantidad pequeña para una recarga de prueba: lava.top no tiene modo de prueba, así que la única forma de comprobar la configuración de principio a fin es un pago real (el mínimo es 50 ₽ / 5 $ / 5 €).

Paso 1. Registro y verificación

Regístrate en lava.top y completa tu perfil: con el perfil vacío, la página de pago le parece a medio hacer al comprador.

Después entra en Balance → verificación y complétala: documento y selfi, 18+, sin VPN activada.

Vender puedes incluso antes de la verificación, pero retirar el dinero sin ella no. No la dejes para tu primer retiro.

Paso 2. Crea tus productos

El precio de una oferta de lava.top es el importe de la recarga. Crea tantas ofertas como importes quieras ofrecer a tus clientes.

  • Recarga única: un producto digital, curso o consulta con precio fijo. Una oferta da un importe, por ejemplo 300, 500 o 1000 ₽.
  • Recarga automática: un producto de tipo «Suscripción». lava.top cobra el precio de la oferta automáticamente según su periodicidad (cada mes, cada 3 meses, cada 6 meses o cada año), y cada cobro recarga el saldo del cliente.
  • La oferta necesita un precio en la moneda de la cuenta de los clientes. La moneda está en la sección «Monetización», en la tarjeta «Saldo de los clientes». lava.top acepta rublos, dólares y euros.
  • Oculta los productos de tu página pública de lava.top mediante el ajuste de visibilidad. No actives «Precio a consultar por API»: CreateYourVPN funciona con ofertas de precio fijo. Una compra hecha directamente en tu página de lava.top llega sin nuestra marca, y no sabremos de quién es el pago. Los productos ocultos de precio fijo siguen apareciendo en tu panel.

Una oferta en lava.top es una forma de vender un producto con un precio y un periodo de cobro determinados. Un producto puede tener varias ofertas, y en tu panel eliges la adecuada para cada importe.

Paso 3. Conecta la cuenta en CreateYourVPN

Todo lo necesario del lado de lava.top está en un mismo sitio: Integrations en el menú de la izquierda, la tarjeta API.

La sección «Integrations» de lava.top: las tarjetas API y Web-Widget

Crea una clave API

Abre la tarjeta API y pulsa «Create API key». La clave se muestra una sola vez, así que cópiala enseguida: lava.top no volverá a mostrarla, y una clave perdida solo se puede sustituir por otra nueva.

La página de claves API: el botón «Create API key» y el enlace al historial de webhooks

Pega la clave en tu panel

En CreateYourVPN abre la sección «Monetización», pulsa «Conectar» en la tarjeta lava.top, pega la clave en el campo «Clave API de lava.top» y guarda.

Comprobamos la clave al momento y respondemos «Clave aceptada», con el número de productos encontrados en tu cuenta, o «lava.top no aceptó esta clave».

Justo después de guardar aparecen en el mismo formulario dos valores más: Webhook URL y clave del webhook. Son los que pegarás en lava.top en el paso siguiente. La clave del webhook la generamos nosotros, no tienes que inventar nada.

Añade el webhook

lava.top te lo propone justo después de crear la clave: pulsa «+ Add Webhook». El mismo botón está también después, en la página de API.

La ventana «API key successfully added» con el botón «+ Add Webhook»

Solo necesitas un webhook: en el campo «Tipo de evento» se marcan todos los eventos a la vez.

El formulario para añadir un webhook: URL, tipo de evento, tipo de autenticación y el campo de la clave API

URL: la dirección del webhook de tu panel. lava.top solo acepta HTTPS, y la nuestra ya lo es.

Tipo de evento: marca todos los eventos de la lista. La selección es múltiple, así que no hace falta un segundo webhook.

Type of authentication for Webhook: elige «API key of your service» y pega en el campo «API key» la clave del webhook de tu panel. Basic también vale, la aceptamos, pero son dos campos en lugar de uno.

Comment: opcional, para ti. Una nota del tipo «CreateYourVPN, pagos» ayuda cuando tienes varias integraciones.

lava.top no añade una firma criptográfica al cuerpo de la petición, así que la entrega la autentica la clave del webhook. Trátala como una contraseña.

No dejes ningún evento sin marcar: sin los eventos de pagos recurrentes, las recargas automáticas de tus clientes nunca llegarán a su saldo. Marcarlo todo siempre es seguro.

Qué nos da la clave API

lava.top no tiene claves «de solo lectura»: una clave API da acceso completo a la cuenta de autor. La usamos exactamente para tres cosas: crear el pago cuando un cliente pulsa «Pagar»; leer tu catálogo de productos para que puedas elegir las ofertas en tu panel; y cancelar una suscripción cuando un cliente desactiva la recarga automática o la renovación automática en su área personal. Nunca cambiamos precios, nunca exportamos tus ventas y no tocamos nada más. La clave se guarda cifrada, no se vuelve a mostrar y nunca aparece en nuestros logs. Si algún día quieres cortar el acceso, elimina la conexión en tu panel: la clave se borra con ella.

Paso 4. Añade los importes de recarga

Abre «Planes» y busca el bloque «Recarga de saldo».

Pulsa «Añadir recarga», elige una oferta única en la lista «Oferta de lava.top» y pulsa «Añadir recarga» en la ventana. El importe será igual al precio de la oferta. Añade así cada importe, hasta 20.

Para una recarga automática, pulsa «Añadir recarga automática», elige una suscripción de lava.top y pulsa «Añadir recarga automática» en la ventana. La oferta fija el importe y la frecuencia, por ejemplo 500 ₽ cada mes. El panel te indica para qué plan alcanza esa recarga.

Revisa los avisos de las filas, si los hay. El panel te dirá cuándo la oferta no tiene precio en la moneda del saldo, cuándo cuesta algo distinto del importe y cuándo ya no está en lava.top.

¿Acabas de crear un producto en lava.top y no lo ves en la lista? Pulsa «Actualizar lista»: el catálogo se cachea durante un minuto.

Mientras no añadas ningún importe ni conectes PayHot, tus clientes no tienen con qué recargar: en la ventana «Recargar saldo» verán «La recarga aún no está disponible». Añade al menos un importe igual o superior al precio de tu plan más caro: así un cliente con el saldo vacío podrá recargar y comprar el plan con un solo pago, con el botón «Recargar y comprar».

En el propio plan no se elige ninguna oferta: un plan en la moneda de la cuenta se compra con el saldo. La excepción es un plan con precio en otra moneda y vinculado antes a una oferta: el cliente lo paga directamente a través de lava.top.

Qué ve el cliente

En el área personal de tu escaparate, el cliente pulsa «Recargar». En la pestaña «Una vez» elige uno de tus importes y un método de pago: tarjeta, SBP (solo rublos) o PayPal si la oferta tiene precio en dólares o euros. En la pestaña «Automática» activa una recarga automática: con tarjeta o PayPal, porque las suscripciones de lava.top no admiten SBP. El saldo siempre recibe el importe de la recarga en la moneda de la cuenta, aunque el cliente haya pagado en otra moneda.

La recarga automática necesita un plan de tipo suscripción con duración y precio en la moneda de la cuenta: sin él, el cliente no tiene la pestaña «Automática». Funciona junto con la renovación automática del plan con el saldo: la renovación automática se activa sola cuando el cliente activa la recarga automática, y si el cliente aún no tiene plan, el primer cobro lo compra. Cada cliente tiene una sola recarga automática.

Paso 5. Compruébalo con un pago real

Desde una cuenta de cliente en tu escaparate, recarga el saldo con el importe más pequeño. En un minuto el dinero debería aparecer en el saldo, y en la sección «Monetización», en el «Registro de pagos», debería aparecer una recarga de saldo con el estado «Procesado». Después compra un plan con el saldo.

Si no ocurre:

  • el evento no está en el registro en absoluto: el webhook de lava.top apunta a la dirección equivocada, no tiene marcados todos los eventos o su clave no coincide con la de tu panel. lava.top tiene un historial de webhooks con botón de reenvío: empieza por ahí;
  • el evento está, pero el dinero no está en el saldo: el evento lleva la nota «No abonado al saldo» con una indicación. Revisa el pago en lava.top y abona el importe con un ajuste en la ficha del cliente;
  • «Sin asociar»: no supimos de quién es el pago. Ocurre cuando un cliente compró un producto directamente en tu página de lava.top, sin pasar por el escaparate. Busca al cliente y abona el importe con un ajuste en su ficha;
  • «Requiere atención»: el evento necesita una decisión tuya, y el propio evento dice qué hacer.

Si un cobro de la suscripción falla, lava.top hace dos intentos más, a las 8 y a las 24 horas, y solo envía el aviso de fallo después del último. El cliente ve en su área personal que el último cobro no se pudo realizar. El dinero que ya está en el saldo sigue siendo del cliente.

Sobre el dinero

  • Comisión de lava.top: 8 % de cada pago con éxito. Se cobra al momento y no se devuelve si luego reembolsas al cliente.
  • Los reembolsos se hacen desde el panel de lava.top, sección «Ventas»; un reembolso de una suscripción la cancela. El aviso de un reembolso o contracargo llega al registro con el estado «Requiere atención». El saldo del cliente no baja solo tras un reembolso: descuenta el mismo importe con un ajuste en la ficha del cliente.
  • Desactivar la recarga automática. El cliente la desactiva en su área personal de tu escaparate, y pedimos a lava.top que cancele la suscripción. Si el cliente desactiva la renovación automática de su plan, la recarga automática se desactiva con ella. También puedes cancelar la suscripción en el panel de lava.top. En cualquier caso, el dinero del saldo no se pierde.
  • Un contracargo se puede iniciar hasta 540 días después del pago, y tienes 3 días para aportar pruebas. Guarda tus condiciones de venta, la correspondencia con el cliente y las pruebas de que se dio el acceso.
  • Los límites de pago dependen del tipo de producto. El mínimo siempre es 50 ₽ / 5 $ / 5 €. Para suscripciones, el máximo es 300 000 ₽ / 3 000 $ / 3 000 €; para productos de pago único, 1 000 000 ₽ / 10 000 $ / 10 000 €.

Si se filtra una clave

En la tarjeta de lava.top hay dos botones distintos, y hacen cosas distintas:

  • «Renovar la clave del webhook» emite una clave nueva para las notificaciones entrantes. Pega el nuevo valor en el webhook de lava.top; hasta que lo hagas, los pagos no se confirmarán.
  • «Rotar la URL del webhook» emite una dirección nueva. La antigua deja de funcionar al momento; actualízala también en el webhook.

Si se ha filtrado la propia clave API, revócala en lava.top, crea una nueva y pégala en tu panel.

On this page