Configurando conector iugu na VTEX
O conector da iugu é um facilitador de integração entre Vtex e iugu, com a finalidade de auxiliar na cobrança de vendas e permitimos ao Marketplace a opção de Split de Pagamento.
Pré-requisitos
- Plataforma Vtex, contratada e com url publicada
- Contrato com a iugu
- Métodos de pagamento habilitado na plataforma da iugu ( PIX, Boleto Bancário e Cartão de Crédito). Verifique no Painel iugu >> Configurações >> Recebimento.
- Id da conta iugu e chave api de produção.
Funcionalidades disponíveis
- Vendas avulsas
- Split de pagamentos para marketplace (MVP)
- Recorrência pela Vtex (MVP)
Localizando ID da conta e chave API no painel da iugu
ID da conta
Para localizar o id de sua conta iugu, siga os passos baixo:
- Acesse seu painel da iugu;
- Clique em configurações;
- Em seguida, clique em informações da conta e dados conta;
- Copie o ID que está abaixo de "ID da conta".

Tokens API!
- Trate seus tokens API como senhas. Não inclua seu token API publicamente em nenhum lugar do seu site(client-side) lembre-se que esta chave dá acesso total aos seus dados na iugu. Então ela deve ser utilizada apenas via server-side.
- Recomendamos que você atualize sua chave de API a cada 30 dias - é importante que você mantenha sua chave atualizada evitando que ela seja usada no caso de vazamento de suas informações.
Habilitando conector iugu
Ao acessar a plataforma é necessário acessar o menu Configurações da loja >> Pagamentos >> Configurações :

Em seguida você deve acessar a opção Afiliações de Gateways e clicar em adicionar:

Onde deve ser adicionado um conector iugu:

Atenção!!
Antes de confirmar o conector iugu se atente a nomenclatura, poderá haver nomes semelhantes. Como por exemplo "iuguu", sendo a nomenclatura correta é iugu.
A próxima tela, será de configuração do conector. É necessário preencher as seguintes informações abaixo:
- Application Key (id da conta iugu)
- Application Token (chave API)
- Prazo de vencimento do boleto (deverá ser o mesmo configurado no painel da iugu, caso utilize esse método de pagamento).
Em seguida, preencha os campos da tela de configuração:

Como localizar o ID da conta e o token API?
Veja nossa FAQ "ID da conta e tokens de API teste e produção"
Configurando condições de pagamento.
Para isso clique em condições de pagamento ⇾ adicionar.

Configurando método de pagamento PIX:
Para habilitar, acesse o Painel Alia Configurações, vá até a opção PIX no menu do lado esquerdo da tela para ativar como método de pagamento: marcar como Ativo e clique em Salvar.
Para habilitar na VTEX clique em condições de pagamento > adicionar.
Escolha o método de pagamento PIX e clique nele para configurar.
Selecione a afiliação iugu criada anteriormente, atualize o status da condição de pagamento, adicione condições especiais caso necessário e clique em salvar.
Configurando método de pagamento Cartão de Crédito
Para habilitar, acesse o Painel Alia Configurações, vá até a opção Cartão de Crédito no menu do lado esquerdo da tela para ativar como método de pagamento: marcar como Ativo, configure Descrição na Fatura, Parcelas e clique em Salvar.
Fluxo de Pagamento em Duas Etapas
Caso esteja habilitado, as transações serão autorizadas e canceladas após 7 dias pois o conector VTEX não está preparado para capturar a transação.
Para configurar o método de cartão de crédito na VTEX, ir até a opção Condições de Pagamentos, ir em adicionar e escolha qual bandeira de cartão a ser configurada.
Atenção!!
Para o método de pagamento cartão de crédito, será preciso configurar em cada bandeira, conforme exemplo abaixo:
Após escolher, habilitar o status para ativa, selecionar iugu em processar com a afiliação e definir o modelo de cobrança à vista ou parcelado e salvar.
Caso opte por receber parcelado, é possível realizar repasse de juros do pagador.
Configurando método de pagamento boleto
Para habilitar, acesse o Painel Alia > configurações, vá até a opção Boleto no menu do lado esquerdo da tela para ativar como método de pagamento: marcar como Ativo, configure os prazos e clique em Salvar.
Após ativar no Painel Alia, acessar as configurações na VTEX.
Ative o boleto e processar com a afiliação iugu
Marketplace com Split de pagamento
Pré-requisitos
- Habilitado modo marketplace na Vtex.
- Plano iugu Marketplace
Configurando Marketplace com Split de Pagamento
É obrigatório que cada seller esteja cadastrado utilizando o mesmo CNPJ na VTEX e no Painel iugu.
Atenção!!
- Não recomendado ter mais de uma subconta na iugu e mais de um seller na Vtex com o mesmo CNPJ, caso tenha haverá conflito no momento do split.
- Caso tenha configurado o Split no Painel iugu ele não refletirá na VTEX.
As configurações de Split, serão realizadas nas configurações de cada seller dentro de seu painel administrador Vtex. Para auxiliar nesse processo deixamos abaixo um exemplo de configuração e a Vtex disponibiliza a documentação sobre configuração dos sellers.
A liquidação do Split ocorrerá conforme seu método de pagamento e acordo comercial com a iugu. Cada método de pagamento tem um tempo de compensação diferente.
Criação de subconta(sellers) na iugu:
Há duas formas de se criar subcontas na iugu, essas formas são:
Observação:Caso crie a subconta via API é necessário disparar a requisição enviar a verificação da subconta (Doc API).
Habilitando Split de Pagamento iugu na Vtex.
- Acesse a opção “Afiliações de Gateway” clicando em: Configurações da loja >> Pagamentos >> Configurações .
- Em seguida clique em “+”, para adicionar uma nova afiliação de gateway ou selecione caso já tenha uma cadastrada.
- Configure as informações:
- Application Key (id da conta iugu)
- Application Token (chave API)
- Prazo de vencimento do boleto (deverá ser o mesmo configurado no painel da iugu, caso utilize esse método de pagamento)
- Ativar divisão e enviar recebedores? Esta opção habilita o Split de pagamentos, após selecionar a opção “sim”, aparecerá mais duas opções:
Responsabilidade pelas tarifas de pagamento e Responsabilidade pelos estornos.

Atenção:
Não está disponível ambiente de teste, caso utilize chave de ambiente de teste isso não será aplicado a sua conta e retornará erro. Quando estiver disponível iremos comunicar.
- Após configurado, salve e aguarde cerca de 10 minutos para a funcionalidade de split ser ativada nos métodos de pagamentos.
Exemplo de configuração do Comissionamento em cada seller vinculado na VTEX:
Informação importante!
As imagens atreladas a essa documentação servem apenas como exemplo e sua visualização dentro da plataforma VTEX poderá ser diferente, nesse caso orientamos a consultar a documentação da VTEX sobre Split de Pagamento.
Dentro da plataforma VTEX acesse Marketplace >> Gerenciamento:
Acesse o seller que realizará a configuração do Split.
Nessa tela será possível realizar o comissionamento por percentual sobre produto ou frete, e caso necessário adicionar comissões por categoria.
Recorrência na Vtex
Pré-requisitos
- Habilitado modo Recorrência na VTEX
- Métodos de pagamento habilitado na plataforma da iugu ( Boleto Bancário e Cartão de Crédito). Verifique no Painel iugu >> Configurações >> Recebimento.
- Conector iugu habilitado na Vtex (configurado comId da conta iugu e Chave api de produção.
- Condições de pagamentos habilitado na Recorrência Boleto e Cartão de Crédito.
Particularidades.
Após habilitado o modo de recorrência, é necessário criar planos que será o motor de recorrência das assinaturas e criação de faturas.
Para configurar acesse a documentação da Vtex: Como configurar Assinaturas na sua loja
Informação importante!
A Vtex é responsável pelo motor de recorrência e criará cada ciclo da assinatura, sendo assim, na no painel da iugu será apresentado como fatura avulsa.
Exemplos de Criação de Planos na VTEX
Acesse Pedidos >> Assinaturas >> Planos >> Novo Plano:
Configure nome e periodicidade de cada plano:
Adicione o vincule o produto ao plano:
Atenção!!
- O produto Split de Pagamento e Recorrência estão em MVP, caso tenha interesse entre contato conosco.
Reportar erro
Caso ocorra alguma eventualidade em relação ao pagamento, em todos os casos é necessário nos encaminhar os eventos da transação. Para isso você deve acessar sua conta Vtex e seguir o caminho abaixo:
Pedidos > Transações:

Buscar/Selecionar transação:
Eventos da transação:

Obs.: É necessário nos encaminhar todo o evento da transação em um arquivo ".txt" através do nosso suporte.
Atenção!!
A Vtex possui um tempo de até 10 minutos para que a configuração ou ajuste esteja disponível.
Updated 23 days ago