Como conectar o ЮKassa a um site no Turbosite

O ЮKassa é um serviço russo de processamento de pagamentos (antigo Яндекс.Касса). Permite aceitar pagamentos no site via cartões, SBP, SberPay, T-Pay e carteiras eletrônicas. Para um site de página única no Turbosite, a maneira mais fácil é usar um formulário de pagamento — ele pode ser criado na sua conta pessoal e incorporado como código HTML. A comissão é a partir de 2,8% por pagamento bem-sucedido; a conexão e o construtor em si não têm custo. A conexão leva de 1 a 2 dias (é necessário um contrato), e a instalação do código leva 10 minutos.

O que será necessário

Uma conta no ЮKassa e um contrato assinado — registro em yookassa.ru
Um site publicado no Turbosite
10–20 minutos

⚠️ Importante: para conectar o ЮKassa, é necessário ser um empreendedor individual (ИП), uma empresa (ООО) ou um trabalhador autônomo (самозанятый). O serviço não está disponível para pessoas físicas sem status jurídico.

Passo 1. Conectar-se ao ЮKassa

Registre-se em yookassa.ru.
Preencha os dados da sua organização (são necessários o INN, dados bancários e passaporte).
Envie os dados para verificação. Geralmente leva de 1 a 2 dias.
Após a aprovação, assine o contrato online (via SMS ou assinatura eletrônica).

Passo 2. Criar um formulário de pagamento

Acesse a conta pessoal do ЮKassa.
Abra o construtor de formulário de pagamento.
Configure o formulário:
- Especifique o nome do produto ou serviço.
- Defina o valor (fixo ou com possibilidade de entrada pelo comprador).
- Ative os campos necessários: nome, e-mail, telefone.
- Escolha os métodos de pagamento que estão conectados ao seu contrato.
Clique em «Получить код» (Obter código).
Copie o código HTML gerado na íntegra.

📷 Captura de tela: construtor de formulário de pagamento com configurações e o botão «Получить код».

Passo 3. Inserir o código no Turbosite

Ao contrário de chats e contadores, o formulário de pagamento deve ser inserido onde ele deve aparecer na página, e não dentro de <head>. Se o Turbosite não tiver um bloco de “código HTML no corpo da página”, verifique com o suporte do serviço como inserir código inline.

Se houver tal bloco:

Abra seu site no Turbosite.
Adicione o bloco “HTML-код” no local desejado da página (por exemplo, após o bloco com a descrição do produto).
Cole o código do ЮKassa.
Salve as alterações.
Publique o site.

📷 [captura de tela do Turbosite — será adicionada: bloco de código HTML no corpo da página com o formulário do ЮKassa inserido].

Passo 4. Verificar se o pagamento funciona

Abra o site publicado.
Preencha o formulário e clique no botão de pagamento.
A página do ЮKassa será aberta com a seleção do método de pagamento.
Para testar, faça um pagamento com o valor mínimo (ou use o modo de teste, se estiver ativado na sua conta pessoal).

Após o pagamento bem-sucedido, o dinheiro será creditado na sua conta corrente no próximo dia útil.

Perguntas frequentes

Preciso de uma caixa registradora online (online-kassa)? De acordo com a lei 54-ФЗ, ao aceitar pagamentos de pessoas físicas, é necessário emitir um recibo. O ЮKassa possui uma solução integrada para caixas online (ativada na conta pessoal) — ela envia automaticamente os recibos aos compradores e ao fisco.

Posso alterar o design do formulário? O design do formulário de pagamento padrão é fixo. Se você precisar incorporar o pagamento com um design personalizado, isso é feito através do widget de pagamento do ЮKassa, mas ele é conectado via API e requer um desenvolvedor.

Quais métodos de pagamento estão disponíveis? Cartões bancários (Mir, Visa, Mastercard), SBP, SberPay, T-Pay, Mir Pay, carteiras eletrônicas, pagamento parcelado e crédito. Eles são ativados na conta pessoal.

Quando o dinheiro chegará à conta? No próximo dia útil. A comissão é cobrada apenas sobre pagamentos bem-sucedidos: a partir de 2,8% para cartões, a partir de 0% para SBP.

O que ver a seguir

Formulário de pagamento para o site — descrição oficial
Documentação para desenvolvedores — se precisar de configuração avançada
Ajuda do ЮKassa — central de suporte
Tarifas — comissões atuais