Como conectar o CloudPayments a um site no Turbosite

O CloudPayments é um serviço russo de adquirência online. É adequado para aceitar pagamentos com cartão, via SBP, SberPay, T-Pay e parcelamentos. A principal característica são os pagamentos recorrentes (assinaturas). A conexão para empresas é gratuita, com uma comissão a partir de 2,5% por pagamento bem-sucedido. A instalação leva de 10 a 20 minutos após a assinatura do contrato.

O que você precisará

Uma conta no CloudPayments e um contrato assinado — solicitação no site cloudpayments.ru
Um site publicado no Turbosite
10–20 minutos

⚠️ Importante: para a conexão, são necessários um registro como empresário individual (IP), empresa (OOO) ou autônomo. O registro e a assinatura do contrato levam de 1 a 3 dias.

Passo 1. Conectar-se ao CloudPayments

Deixe uma solicitação em cloudpayments.ru — um gerente entrará em contato com você.
Assine o contrato e obtenha acesso à sua conta pessoal.
Na sua conta pessoal, encontre o seu Public ID — esta é a chave pública; sem ela, o widget não funcionará. Ela fica armazenada na seção «Сайты» (Sites) → selecione o site.

O CloudPayments funciona através de um widget: um pequeno script é inserido no site e, ao clicar no botão de pagamento, uma janela pop-up com o formulário de entrada do cartão é aberta.

A maneira mais fácil é usar o código pronto:

<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: 'SEU_PUBLIC_ID',
            description: 'Pagamento de produto',
            amount: 1000,
            currency: 'RUB',
            invoiceId: 'ORDER_001',
            accountId: '[email protected]'
        },
        {
            onSuccess: function (options) { alert('Pagamento realizado!'); },
            onFail: function (reason, options) { alert('Erro: ' + reason); }
        }
    );
}
</script>

Substitua SEU_PUBLIC_ID pela sua chave da conta pessoal, amount pelo valor desejado e description pelo nome do produto.

📷 Captura de tela: conta pessoal do CloudPayments → seção «Сайты» (Sites) → campo Public ID.

⚠️ Verificar atualização: os nomes exatos das seções e a localização do Public ID podem variar. Se não encontrar, entre em contato com o suporte do CloudPayments.

Passo 3. Inserir o código no Turbosite

O widget funciona em duas etapas: o script é conectado globalmente e o botão de pagamento é colocado no local desejado da página.

Script do widget:

Abra o seu site no Turbosite.
Vá para Configurações do site → Integrações → Código HTML em <head> (esta é a parte técnica da página — os visitantes não a veem, mas os scripts de lá são carregados ao abrir o site).

Insira apenas esta linha:

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

Adicione o botão de pagamento como um bloco HTML separado no corpo da página — no local onde ele deve aparecer.

Passo 4. Verificar se o pagamento funciona

Abra o site publicado.
Clique no botão “Pagar” — a janela pop-up do CloudPayments deve abrir.
Para testar, use o Public ID de teste (fornecido na conta pessoal) e os cartões de teste da documentação.
Verificação real — realize um pagamento mínimo com um cartão real.

Perguntas frequentes

Como configurar uma assinatura (pagamentos recorrentes)? No código do widget, adicione o parâmetro data especificando a periodicidade. Detalhes na documentação do CloudPayments.

Como enviar recibos aos compradores (54-FZ)? Na conta pessoal do CloudPayments, conecte o módulo de fiscalização (caixa online). Os recibos serão enviados automaticamente.

Quais métodos de pagamento estão disponíveis? Cartões Mir, Visa, Mastercard, SBP, SberPay, T-Pay, Apple/Google Pay (para dispositivos compatíveis), parcelamentos de bancos parceiros.

Quando o dinheiro chegará à conta? Por padrão, no próximo dia útil. É possível configurar prazos mais rápidos, o que deve ser discutido com o gerente.

Onde procurar mais informações

Documentação do CloudPayments — documentação técnica completa
Descrição do widget — parâmetros e configurações
Conta pessoal — gestão de pagamentos