Cómo conectar CloudPayments a un sitio web en Turbosite

CloudPayments es un servicio ruso de adquirencia de internet. Es adecuado para aceptar pagos con tarjeta, a través de SBP, SberPay, T-Pay y cuotas. Su característica principal son los pagos recurrentes (suscripciones). La conexión para empresas es gratuita, con una comisión a partir del 2,5% por pago exitoso. La instalación toma de 10 a 20 minutos después de firmar el contrato.

Qué necesitará

Una cuenta en CloudPayments y un contrato firmado: solicitud en el sitio web cloudpayments.ru
Un sitio web publicado en Turbosite
10–20 minutos

⚠️ Importante: para la conexión se requiere ser ИП (empresario individual), ООО (sociedad de responsabilidad limitada) o autónomo. El registro y la firma del contrato toman de 1 a 3 días.

Paso 1. Conectarse a CloudPayments

Envíe una solicitud en cloudpayments.ru y un gestor se pondrá en contacto con usted.
Firme el contrato y obtenga acceso a su cuenta personal.
En su cuenta personal, busque su Public ID: es la clave pública, sin ella el widget no funcionará. Se encuentra en la sección «Сайты» (Sitios web) → seleccione el sitio.

CloudPayments funciona a través de un widget: se inserta un pequeño script en el sitio web y, al hacer clic en el botón de pago, se abre una ventana emergente con el formulario de ingreso de la tarjeta.

La forma más sencilla es utilizar el código ya preparado:

<script src="https://widget.cloudpayments.ru/bundles/cloudpayments.js"></script>
<button onclick="pay()">Оплатить</button>
<script>
function pay() {
    var widget = new cp.CloudPayments();
    widget.pay('charge',
        {
            publicId: 'SU_PUBLIC_ID',
            description: 'Pago de producto',
            amount: 1000,
            currency: 'RUB',
            invoiceId: 'ORDER_001',
            accountId: '[email protected]'
        },
        {
            onSuccess: function (options) { alert('¡Pago realizado!'); },
            onFail: function (reason, options) { alert('Error: ' + reason); }
        }
    );
}
</script>

Reemplace SU_PUBLIC_ID con su clave de la cuenta personal, amount con el monto deseado y description con el nombre del producto.

📷 Captura de pantalla: cuenta personal de CloudPayments → sección «Сайты» → campo Public ID.

⚠️ Verificar actualidad: los nombres exactos de las secciones y la ubicación del Public ID pueden variar. Si no los encuentra, contacte al soporte de CloudPayments.

Paso 3. Insertar el código en Turbosite

El widget funciona en dos etapas: el script se conecta globalmente y el botón de pago se coloca en el lugar deseado de la página.

Script del widget:

Abra su sitio web en Turbosite.
Vaya a Configuración del sitio → Integraciones → Código HTML en <head> (esta es la parte técnica de la página; los visitantes no la ven, pero los scripts se cargan desde allí al abrir el sitio).

Inserte solo esta línea:

<script src="https://widget.cloudpayments.ru/bundles/cloudpayments.js"></script>

Agregue el botón de pago como un bloque HTML independiente en el cuerpo de la página, en el lugar donde deba aparecer.

Paso 4. Verificar que el pago funcione

Abra el sitio web publicado.
Haga clic en el botón «Оплатить» (Pagar): debería abrirse la ventana emergente de CloudPayments.
Para la prueba, utilice el Public ID de prueba (proporcionado en la cuenta personal) y las tarjetas de prueba de la documentación.
Verificación real: realice un pago mínimo con una tarjeta real.

Preguntas frecuentes

¿Cómo configurar una suscripción (pagos recurrentes)? En el código del widget, agregue el parámetro data especificando la periodicidad. Detalles en la documentación de CloudPayments.

¿Cómo enviar recibos a los compradores (ley 54-FZ)? En la cuenta personal de CloudPayments, conecte el módulo de fiscalización (caja registradora en línea). Los recibos se enviarán automáticamente.

¿Qué métodos de pago están disponibles? Tarjetas Mir, Visa, Mastercard, SBP, SberPay, T-Pay, Apple/Google Pay (para dispositivos compatibles), cuotas de bancos asociados.

¿Cuándo llegará el dinero a la cuenta? Por defecto, el siguiente día hábil. Se pueden configurar plazos más rápidos, lo cual se discute con el gestor.

Qué consultar a continuación

Documentación de CloudPayments — documentación técnica completa
Descripción del widget — parámetros y configuraciones
Cuenta personal — gestión de pagos