Na VTEX, é possível realizar a integração com o provedor de pagamento Tino. Por meio deste provedor, sua loja pode realizar vendas utilizando o meio de pagamento Tino.
Para habilitar o provedor Tino, é necessário:
- Instalar os aplicativos Tino e Tino UI
- Configurar o Tino app
- Configurar o provedor Tino
- Configurar condição de pagamento
- Instalar script de customização no checkout (opcional)
- Configurar conciliação (opcional)
Instalar aplicativos Tino e Tino UI
Para iniciar a implementação do provedor Tino em sua loja é necessário habilitar dois aplicativos:
- Tino app: gerencia o processamento de pagamentos
- Tino Ui app: controla a interface gráfica do sistema de pagamentos.
As instalações dos apps Tino e Tino UI podem ser realizadas em sua loja por meio do VTEX IO CLI ou do Admin VTEX.
Antes de iniciar a instalação por qualquer um dos métodos, verifique com a equipe de suporte da Tino os números das versões mais atuais dos aplicativos.
Instalação via VTEX IO CLI
- No VTEX IO CLI, execute o comando
vtex login nomedaconta
para realizar o login em sua conta. - Instale o Tino app por meio do comando
vtex install tinopartnerbr.ppp-tino@{{current-app-version}}
. A informação{{current-app-version}}
deve ser substituída pela a versão atual do aplicativo, por exemplo: vtex install tinopartnerbr.ppp-tino@0.0.50. - Instale o Tino UI app por meio do comando
vtex install tinopartnerbr.ppp-tino-payments@{{current-app-version}}
. A informação{{current-app-version}}
deve ser substituída pela a versão atual do aplicativo, por exemplo: vtex install tinopartnerbr.ppp-tino-payments@1.0.9.
Instalação via Admin VTEX
Configurar Tino app
Após instalar os aplicativos, você precisa realizar a configuração do Tino app. Para acessar a tela de configurações, siga os passos abaixo:
- No Admin VTEX, acesse Aplicativos > Hub de Extensões > Gerenciamento de Aplicativos, ou digite Gerenciamento de Aplicativos na barra de busca no topo da página.
- Localize o Tino App e clique em Configurações.
- Na página de configurações, preencha os campos abaixo com informações fornecidas pelo time de suporte da Tino.
- API Key: chave para o processamento de pagamentos
- SDK Api Key: chave para a operação do fluxo de checkout.
As informações inseridas não devem conter espaços em branco entre caracteres.

A opção Enable Development Mode deve ser mantida desmarcada. Caso esteja sinalizada, o aplicativo estará operando somente em modo de teste e não será possível processar transações de pagamento com a Tino durante o período.
Configurar pagamento com Tino
- No Admin VTEX, acesse Configurações da loja > Pagamentos > Provedores, ou digite Provedores na barra de busca no topo da página.
- Na tela de provedores, clique no botão
Novo provedor
. - Digite o nome Tino na barra de busca e clique sobre o nome do provedor.
- Em Autorização do provedor, não é necessário preencher os campos Chave de aplicação e Token de aplicação.
- Caso deseje modificar o nome de identificação a ser exibido para o provedor Malga na tela do Admin VTEX, insira a informação no campo Nome em Informações básicas.
- Em Controle de pagamento, desative o ambiente de teste ao desmarcar a opção Ativar modo de teste.
- Em Liquidação automática, selecione a opção Usar comportamento recomendado pelo processador de pagamento.
Configurar condição de pagamento
- No Admin VTEX, acesse Configurações da loja > Pagamentos > Configurações, ou digite Configurações na barra de busca no topo da página.
- Na aba Condições de Pagamentos, clique no botão
+
. - Localize e clique sobre a opção Tino.
- Ative a condição no campo Status.
- Se desejar utilizar um sistema antifraude, selecione a opção Usar solução antifraude.
- Se desejar, você também pode configurar condições especiais de pagamento.
- Clique em
Salvar
.
Script de customização no checkout (opcional)
A Tino disponibiliza a opção de coletar dados de navegação e métricas relacionadas a navegação do cliente no checkout, de forma a identificar problemas e melhorar a experiência do usuário. Para isso, é necessário implementar um script de customização do checkout por meio do VTEX IO CLI ou do Admin VTEX.
Caso deseje ativar esta customização, os dados de perfil do cliente (clientProfileData) poderão ser acessados pela Tino.
Qualquer customização realizada no checkout por meio de um script pode impactar o fluxo de compra do cliente. Caso tenha alguma dificuldade operacional no checkout após configurar o script em sua loja, entre em contato com o suporte da Tino.
Instalando script via Admin VTEX
- No Admin VTEX, acesse Configurações da loja > Storefront > Checkout, ou digite Checkout na barra de busca no topo da página.
- Clique no ícone do site desejado.
- No menu de opções azul localizado na parte superior da página, clique em Código.
- No canto direito da tela, em Arquivos, clique sobre a opção checkout6-custom.js.
- Insira o código JavaScript fornecido pelo suporte da Tino.

- Clique em
Salvar
.
Intalando script via VTEX IO CLI
- No VTEX IO CLI, execute o comando
vtex login nomedaconta
para realizar o login em sua conta. - Acesse o repositório
checkout UI settings
. - Localize e abra o arquivo
checkout6-custom.js
. - Insira o código JavaScript fornecido pelo suporte da Tino dentro arquivo
checkout6-custom.js
. - Localize o arquivo
manifest.json
e atualize a propriedade version para a nova versão. - No repositório, execute os comandos
vtex publish
evtex install
.
Configurar conciliação (opcional)
Para mais informações sobre como utilizar a solução da Tino que permite conciliar os pedidos e repasses realizados a fornecedores, acesse documentação da Tino Conciliação.