Come collegare CloudPayments a un sito su Turbosite

CloudPayments è un servizio russo di internet acquiring. È adatto per accettare pagamenti con carta, tramite SBP, SberPay, T-Pay e rateizzazioni. La caratteristica principale sono i pagamenti ricorrenti (abbonamenti). Il collegamento per le aziende è gratuito, la commissione parte dal 2,5% per ogni pagamento riuscito. L’installazione richiede 10–20 minuti dopo la firma del contratto.

Cosa ti servirà

Un account su CloudPayments e un contratto firmato — richiesta sul sito cloudpayments.ru
Un sito pubblicato su Turbosite
10–20 minuti

⚠️ Importante: per il collegamento sono necessari ИП (imprenditore individuale), ООО (società a responsabilità limitata) o essere un lavoratore autonomo. La registrazione e la stipula del contratto richiedono 1–3 giorni.

Passaggio 1. Collegarsi a CloudPayments

Invia una richiesta su cloudpayments.ru — verrai ricontattato da un manager.
Firma il contratto e ottieni l’accesso all’area personale.
Nell’area personale, trova il tuo Public ID — è la chiave pubblica, senza di essa il widget non funzionerà. Si trova nella sezione «Siti» → seleziona il sito.

CloudPayments funziona tramite un widget: sul sito viene inserito un piccolo script e, cliccando sul pulsante di pagamento, si apre una finestra pop-up con il modulo per l’inserimento dei dati della carta.

Il modo più semplice è utilizzare il codice pronto all’uso:

<script src="https://widget.cloudpayments.ru/bundles/cloudpayments.js"></script>
<button onclick="pay()">Paga</button>
<script>
function pay() {
    var widget = new cp.CloudPayments();
    widget.pay('charge',
        {
            publicId: 'IL_TUO_PUBLIC_ID',
            description: 'Pagamento prodotto',
            amount: 1000,
            currency: 'RUB',
            invoiceId: 'ORDER_001',
            accountId: '[email protected]'
        },
        {
            onSuccess: function (options) { alert('Pagamento effettuato!'); },
            onFail: function (reason, options) { alert('Errore: ' + reason); }
        }
    );
}
</script>

Sostituisci IL_TUO_PUBLIC_ID con la tua chiave dall’area personale, amount con l’importo desiderato e description con il nome del prodotto.

📷 Screenshot: area personale CloudPayments → sezione «Siti» → campo Public ID.

⚠️ Verifica l’attualità: i nomi esatti delle sezioni e la posizione del Public ID potrebbero variare. Se non li trovi, contatta l’assistenza di CloudPayments.

Passaggio 3. Inserire il codice in Turbosite

Il widget funziona in due fasi: lo script viene collegato globalmente e il pulsante di pagamento viene inserito nel punto desiderato della pagina.

Script del widget:

Apri il tuo sito in Turbosite.
Vai su Impostazioni sito → Integrazioni → Codice HTML in <head> (questa è la parte di servizio della pagina — i visitatori non la vedono, ma gli script vengono caricati all’apertura del sito).

Inserisci solo questa riga:

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

Il pulsante di pagamento va aggiunto come blocco HTML separato nel corpo della pagina, nel punto in cui deve apparire.

Passaggio 4. Verificare che il pagamento funzioni

Apri il sito pubblicato.
Clicca sul pulsante «Paga» — dovrebbe aprirsi la finestra pop-up di CloudPayments.
Per il test, usa il Public ID di test (fornito nell’area personale) e le carte di test presenti nella documentazione.
Verifica reale — effettua un pagamento minimo con una carta reale.

Domande frequenti

Come configurare un abbonamento (pagamenti ricorrenti)? Nel codice del widget, aggiungi il parametro data specificando la periodicità. Dettagli nella documentazione di CloudPayments.

Come inviare gli scontrini agli acquirenti (54-FZ)? Nell’area personale di CloudPayments, attiva il modulo di fiscalizzazione (cassa online). Gli scontrini verranno inviati automaticamente.

Quali metodi di pagamento sono disponibili? Carte Mir, Visa, Mastercard, SBP, SberPay, T-Pay, Apple/Google Pay (per dispositivi compatibili), rateizzazioni da banche partner.

Quando arriveranno i soldi sul conto? Di default, il giorno lavorativo successivo. È possibile concordare tempi più rapidi con il proprio manager.

Dove guardare dopo

Documentazione CloudPayments — documentazione tecnica completa
Descrizione del widget — parametri e impostazioni
Area personale — gestione dei pagamenti