CreateYourVPN Academy
Guías

Aceptar pagos con lava.top

Guía paso a paso: cómo conectar tu cuenta de lava.top con CreateYourVPN para que el pago de un cliente se convierta solo en una suscripción — clave API, un webhook y la vinculación de ofertas con tus planes.

lava.top es un proveedor de pagos que acepta tarjetas, SBP y PayPal en rublos, dólares y euros. Lo conectas una vez y el pago en tu escaparate se convierte solo en una suscripción activa: no hace falta conceder el acceso a mano.

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 forma parte del plan de pago Max — es el que pone el escaparate en modo venta. Sobre los precios de la plataforma, mira la lección de facturación.

Qué necesitas

  • una cuenta en lava.top (una cuenta de autor, la que vende);
  • 10–15 minutos para la configuración inicial;
  • una cantidad pequeña para un pago de prueba: lava.top no tiene entorno de pruebas, así que la única forma de comprobar la configuración de principio a fin es una compra real (mínimo 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: 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 el primer cobro.

Paso 2. Crea tus productos

En lava.top crea uno o varios productos para tus planes. Cada plan de CreateYourVPN necesita una oferta correspondiente, pero un mismo producto de lava.top puede contener varias ofertas, por ejemplo mensual y anual.

  • Para un plan recurrente elige el tipo de producto «Suscripción» — lava.top cobrará sola y cada renovación prolongará el acceso con nosotros.
  • Para una compra única, usa un producto digital, curso o consulta con precio fijo.
  • Comprueba que la oferta tenga precio en al menos una moneda compatible: RUB, USD o EUR. La moneda del plan aparece seleccionada por defecto en el escaparate, pero el comprador puede cambiar a cualquier otra moneda disponible en la oferta.
  • Ajusta el periodo de cobro a la duración del plan: producto mensual ↔ 30 días, 90 días ↔ 90, y así sucesivamente.
  • 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 actualmente con ofertas de precio fijo. Una compra directa desde tu página de lava.top llega sin nuestra marca y quizá no se pueda asociar a un plan; entonces aparecerá como «Sin asociar». Los productos ocultos de precio fijo siguen apareciendo en nuestro selector de ofertas.

Una oferta es una forma de vender un producto con un precio y un periodo de cobro determinados. Un producto puede tener varias ofertas; después elegirás la adecuada para cada plan.

Qué pasa con una compra repetida

Un producto de compra única no tiene renovaciones: cuando el cliente quiere más, simplemente vuelve a comprar. Es un escenario normal, y comprar por adelantado es seguro — los días se suman a lo que queda, no se cuentan desde cero. Diez días restantes más un mes nuevo dan cuarenta días.

Una excepción, si el plan además concede tráfico: la cuota se sustituye, no se suma. Un cliente que compró 100 GB, gastó 30 y vuelve a comprar el mismo plan acaba con 100 GB nuevos, no con 170. Tenlo en cuenta al fijar el precio de los planes con tráfico.

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 — cópiala enseguida: lava.top no la mostrará una segunda vez 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 la cuenta — o «lava.top no aceptó esta clave».

Justo después de guardar aparecen en el mismo formulario dos valores más: la URL del webhook y la 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.

Crea 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 hace falta un webhook: en el campo del tipo de evento se marcan a la vez todos los tipos necesarios:

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; la nuestra ya lo es.

Event type — marca los dos tipos: «Payment result» y «Recurring payment». La lista es de selección 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, por lo que la clave secreta del webhook autentica la entrega. Trátala como una contraseña.

No desmarques «Recurring payment» si vendes suscripciones: sin ese tipo de evento las renovaciones no nos llegan y el acceso de un cliente que paga acaba caducando. Para productos de pago único basta con «Payment result», aunque dejar los dos marcados es igual de 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 en el momento en que el cliente pulsa «Pagar»; leer tu catálogo de productos para el selector de ofertas; cancelar una suscripción cuando el cliente desactiva la renovación automática en su panel. No cambiamos precios, no tocamos la exportación de tus ventas y no hacemos nada más con esta clave. Se guarda cifrada, no se muestra en ningún otro sitio y no aparece en nuestros registros. Si quieres cortar el acceso, elimina la conexión en tu panel: la clave se borra con ella.

Paso 4. Vincula las ofertas con tus planes

Abre «Planes», entra en un plan y busca el bloque lava.top:

Pulsa «Cargar productos» — traeremos el catálogo de tu cuenta de lava.top.

Elige la oferta con la que se vende este plan. En la lista se ven el producto, el precio y el periodo de cobro.

Revisa los avisos, si aparecen. El panel te dirá cuándo la oferta no tiene precio en la moneda del plan y cuándo el periodo de cobro no coincide con la duración del plan («cobra cada 30 días, pero el plan concede 365»).

¿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.

El comprador puede cambiar entre todas las monedas disponibles en la oferta elegida. Para un pago único en rublos mostramos tarjeta y SBP; para una suscripción en rublos, solo tarjeta. En dólares y euros están disponibles tarjeta y PayPal.

Paso 5. Compruébalo con un pago real

Compra tú mismo el plan más barato desde una cuenta de cliente en tu escaparate. En un minuto el plan debería aparecer en esa cuenta y el pago en el diario con el estado «Procesado» (sección «Monetización»).

Si no ocurre:

  • el evento no está en el diario en absoluto — el webhook de lava.top apunta a la dirección equivocada, no tiene marcados los tipos de evento necesarios, 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 «Sin asociar» — no supimos de quién es el pago ni por qué plan. Vincúlalo a mano en el propio diario: la suscripción se concederá con el mismo código que en un pago automático;
  • «Requiere atención» — el pago necesita una decisión humana: el cliente está bloqueado en tu panel, o el plan se ha vinculado a otro producto de lava.top después de crear el pago. Aquí no tocamos el acceso por nuestra cuenta — decides tú.

Si no se puede cobrar una renovación, lava.top realiza dos intentos más, a las 8 y 24 horas, y solo envía el aviso de fallo después del último. No retiramos el acceso por un cobro fallido: el periodo ya pagado siempre llega hasta el final. Un aviso de cancelación solo indica que no habrá otra renovación.

Sobre el dinero

  • La comisión de lava.top es del 8 % de cada pago con éxito. Se cobra al momento y no se devuelve si luego reembolsas al cliente.
  • El reembolso se hace desde el panel de lava.top, sección «Ventas»; un reembolso en una suscripción la cancela. lava.top todavía no tiene un tipo de webhook propio para reembolsos y contracargos, así que los verás en el panel de lava.top y no en nuestro diario.
  • Cancelar la renovación automática. El cliente puede hacerlo él mismo en su panel de tu escaparate — nosotros pediremos a lava.top que cancele la suscripción — o en su propia cuenta de lava.top; tú también puedes cancelarla por él desde tu panel de lava.top. La cancelación no le quita el acceso: sigue vigente hasta el final del periodo ya pagado, y nosotros simplemente dejamos de esperar el siguiente cobro.
  • Un contracargo se puede iniciar hasta 540 días después del pago, y tienes 3 días para aportar pruebas. Guarda las condiciones de tu escaparate y la correspondencia con el cliente — así son las pruebas.
  • Los límites 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. Hay que pegar 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; también hay que actualizarla 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