Come collegare ЮKassa a un sito su Turbosite

ЮKassa è un servizio russo di accettazione pagamenti (ex Яндекс.Касса). Consente di accettare pagamenti sul sito tramite carte, SBP, SberPay, T-Pay e portafogli elettronici. Per un sito a pagina singola su Turbosite, il modo più semplice è utilizzare un modulo di pagamento: può essere creato nell’area personale e integrato come codice HTML. La commissione parte dal 2,8% per ogni pagamento riuscito; l’attivazione e il costruttore stesso sono gratuiti. Il collegamento richiede 1-2 giorni (è necessario un contratto), mentre l’installazione del codice richiede 10 minuti.

Cosa ti servirà

Un account ЮKassa e un contratto firmato: registrazione su yookassa.ru
Un sito pubblicato su Turbosite
10-20 minuti

⚠️ Importante: per collegare ЮKassa sono necessari lo status di ИП (imprenditore individuale), ООО (società a responsabilità limitata) o lavoratore autonomo (самозанятый). Il servizio non è disponibile per privati senza tale status.

Passaggio 1. Collegarsi a ЮKassa

Registrati su yookassa.ru.
Inserisci i dati della tua organizzazione (sono necessari INN, coordinate bancarie e passaporto).
Invia i dati per la verifica. Di solito richiede 1-2 giorni.
Dopo l’approvazione, firma il contratto online (tramite SMS o firma elettronica).

Passaggio 2. Creare un modulo di pagamento

Accedi all’area personale di ЮKassa.
Apri il costruttore di moduli di pagamento.
Configura il modulo:
- Specifica il nome del prodotto o servizio.
- Imposta il costo (fisso o con possibilità di inserimento da parte dell’acquirente).
- Attiva i campi necessari: nome, email, telefono.
- Seleziona i metodi di pagamento inclusi nel tuo contratto.
Clicca su «Получить код» (Ottieni codice).
Copia l’intero codice HTML generato.

📷 Screenshot: costruttore del modulo di pagamento con le impostazioni e il pulsante «Получить код».

Passaggio 3. Inserire il codice in Turbosite

A differenza di chat e contatori, il modulo di pagamento deve essere inserito nel punto in cui deve apparire sulla pagina, e non nel tag <head>. Se in Turbosite non è presente un blocco “Codice HTML nel corpo della pagina”, chiedi al supporto del servizio come inserire il codice inline.

Se tale blocco è presente:

Apri il tuo sito in Turbosite.
Aggiungi il blocco “Codice HTML” nel punto desiderato della pagina (ad esempio, dopo il blocco con la descrizione del prodotto).
Incolla il codice di ЮKassa.
Salva le modifiche.
Pubblica il sito.

📷 [screenshot di Turbosite — da aggiungere: blocco codice HTML nel corpo della pagina con il modulo ЮKassa inserito].

Passaggio 4. Verificare che il pagamento funzioni

Apri il sito pubblicato.
Compila il modulo e clicca sul pulsante di pagamento.
Si aprirà la pagina di ЮKassa con la scelta del metodo di pagamento.
Per un test, effettua un pagamento dell’importo minimo (o utilizza la modalità di test, se abilitata nell’area personale).

Dopo il pagamento riuscito, il denaro verrà accreditato sul tuo conto corrente il giorno lavorativo successivo.

Domande frequenti

Ho bisogno di un registratore di cassa online? Secondo la legge 54-FZ, quando si accettano pagamenti da privati è necessario emettere uno scontrino. ЮKassa dispone di una soluzione integrata per i registratori di cassa online (attivabile nell’area personale) che invia automaticamente gli scontrini agli acquirenti e all’ufficio delle imposte.

È possibile modificare il design del modulo? Il design del modulo di pagamento standard è fisso. Se è necessario integrare il pagamento con un design personalizzato, è possibile farlo tramite il widget di pagamento di ЮKassa, che però si collega tramite API e richiede l’intervento di uno sviluppatore.

Quali metodi di pagamento sono disponibili? Carte bancarie (Mir, Visa, Mastercard), SBP, SberPay, T-Pay, Mir Pay, portafogli elettronici, pagamenti a rate e finanziamenti. Si attivano nell’area personale.

Quando arriverà il denaro sul conto? Il giorno lavorativo successivo. La commissione viene detratta solo dai pagamenti riusciti: a partire dal 2,8% per le carte, dallo 0% per SBP.

Approfondimenti

Modulo di pagamento per il sito — descrizione ufficiale
Documentazione per sviluppatori — per configurazioni avanzate
Supporto ЮKassa — centro assistenza
Tariffe — commissioni aggiornate