Comment connecter CloudPayments à un site sur Turbosite

CloudPayments est un service russe d’acquisition en ligne. Il est adapté pour accepter les paiements par carte, via SBP, SberPay, T-Pay et en plusieurs fois. Sa caractéristique principale est la gestion des paiements récurrents (abonnements). La connexion pour les entreprises est gratuite, avec une commission à partir de 2,5 % par paiement réussi. L’installation prend 10 à 20 minutes après la signature du contrat.

Ce dont vous aurez besoin

Un compte CloudPayments et un contrat signé — demande sur le site cloudpayments.ru
Un site publié sur Turbosite
10 à 20 minutes

⚠️ Important : pour la connexion, vous devez être un entrepreneur individuel (IP), une société (OOO) ou un auto-entrepreneur. L’inscription et la conclusion du contrat prennent 1 à 3 jours.

Étape 1. Se connecter à CloudPayments

Faites une demande sur cloudpayments.ru — un responsable vous contactera.
Signez le contrat et obtenez l’accès à votre espace personnel.
Dans votre espace personnel, trouvez votre Public ID — c’est une clé publique, sans laquelle le widget ne fonctionnera pas. Elle se trouve dans la section « Sites » → sélectionnez votre site.

CloudPayments fonctionne via un widget : un petit script est inséré sur le site, et lors du clic sur le bouton de paiement, une fenêtre contextuelle avec le formulaire de saisie de carte s’ouvre.

La méthode la plus simple est d’utiliser le code prêt à l’emploi :

<script src="https://widget.cloudpayments.ru/bundles/cloudpayments.js"></script>
<button onclick="pay()">Payer</button>
<script>
function pay() {
    var widget = new cp.CloudPayments();
    widget.pay('charge',
        {
            publicId: 'VOTRE_PUBLIC_ID',
            description: 'Paiement de produit',
            amount: 1000,
            currency: 'RUB',
            invoiceId: 'ORDER_001',
            accountId: '[email protected]'
        },
        {
            onSuccess: function (options) { alert('Paiement réussi !'); },
            onFail: function (reason, options) { alert('Erreur : ' + reason); }
        }
    );
}
</script>

Remplacez VOTRE_PUBLIC_ID par votre clé provenant de l’espace personnel, amount par le montant souhaité, et description par le nom du produit.

📷 Capture d’écran : espace personnel CloudPayments → section « Sites » → champ Public ID.

⚠️ Vérification de la pertinence : les noms exacts des sections et l’emplacement du Public ID peuvent varier. Si vous ne les trouvez pas, contactez le support de CloudPayments.

Étape 3. Insérer le code dans Turbosite

Le widget fonctionne en deux étapes : le script est connecté globalement, et le bouton de paiement est placé à l’endroit souhaité sur la page.

Script du widget :

Ouvrez votre site dans Turbosite.
Allez dans Paramètres du site → Intégrations → Code HTML dans <head> (il s’agit de la partie technique de la page — les visiteurs ne la voient pas, mais les scripts y sont chargés lors de l’ouverture du site).

Insérez uniquement cette ligne :

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

Ajoutez le bouton de paiement via un bloc HTML séparé dans le corps de la page — à l’endroit où il doit apparaître.

Étape 4. Vérifier que le paiement fonctionne

Ouvrez le site publié.
Cliquez sur le bouton « Payer » — la fenêtre contextuelle de CloudPayments doit s’ouvrir.
Pour le test, utilisez le Public ID de test (fourni dans l’espace personnel) et les cartes de test de la documentation.
Vérification réelle — effectuez un paiement minimal avec une vraie carte.

Foire aux questions

Comment configurer un abonnement (paiements récurrents) ? Dans le code du widget, ajoutez le paramètre data en précisant la périodicité. Plus de détails dans la documentation de CloudPayments.

Comment envoyer des reçus aux acheteurs (54-FZ) ? Dans l’espace personnel de CloudPayments, activez le module de fiscalisation (caisse en ligne). Les reçus seront envoyés automatiquement.

Quels modes de paiement sont disponibles ? Cartes Mir, Visa, Mastercard, SBP, SberPay, T-Pay, Apple/Google Pay (pour les appareils compatibles), paiements en plusieurs fois via les banques partenaires.

Quand l’argent arrivera-t-il sur le compte ? Par défaut, le jour ouvrable suivant. Il est possible de configurer des délais plus rapides, à discuter avec votre responsable.

Pour aller plus loin

Documentation CloudPayments — documentation technique complète
Description du widget — paramètres et configurations
Espace personnel — gestion des paiements