--- updatedAt: 2026-04-06T17:17:51.000Z agentTools: projectIndex: https://docs.pagar.me/v2/llms.txt --- # Split de Pagamentos na VTEX Neste documento, vamos explicar o passo a passo de como usar a integração de split de pagamentos Pagar.me na plataforma VTEX. Caso tenha dúvidas sobre o que é o split de transação Pagar.me, recomendamos que leia [este artigo](https://docs.pagar.me/v1/docs/split-rules) que explica todos os detalhes. ## Requisitos para venda com split Antes de começar, certifique-se de que você tem os pré-requisitos abaixo: * Ter os Sellers cadastrados corretamente na sua loja, com dados válidos. * Ter produtos na sua loja configurados com os Sellers cadastrados na loja. * Ter uma afiliação de gateway com o conector de pagamentos `PagarMeV2` corretamente configurada. **Atenção** Para cadastrar os Sellers na loja e vincular os produtos, solicite suporte da plataforma VTEX. Para começar a realizar suas vendas utilizando o split de pagamentos Pagar.me, é necessário fazer a configuração adequada na afiliação de pagamento da plataforma, conforme as instruçẽos abaixo. ## Como configurar sua loja para realizar o split? Para fazer corretamente a configuração de split Pagar.me na sua loja VTEX, é preciso: * Ter cadastro no Pagar.me. * Ter em mãos sua API Key do Pagar.me - veja como obter sua API Key [aqui](https://docs.pagar.me/docs/api-key-e-encryption-key) * Ter acesso às configurações de pagamento na sua loja VTEX. Uma vez confirmado todos os requisitos acima, siga as instruções abaixo para configurar as opções conforme sua operação de marketplace: ### Criar uma afiliação de pagamento Para criar uma afiliação de pagamento acesse `Pagamentos > Configurações > Afiliações de Gateway > Adicionar nova condição de pagamento`. É a opção do botão verde no canto superior direito da tela. ![Configurando o conector PagarMeV2 - Parte 1](https://i.imgur.com/em2kh3g.png) Na lista de afiliações, selecione o conector `PagarMeV2` ![Configurando o conector PagarMeV2 - Parte 2](https://files.readme.io/1989eac-4-PagarMeV2.png) Após isso você verá essa tela: ![Configurando os campos no conector PagarMeV2](https://i.imgur.com/PIpdLic.png) **Significado dos campos** * `Nome da Afiliação`: Nome que você identificará o conector ao configurar seus meios de pagamento. * `Application Key`: Neste campo você deve colocar a sua API Key do Pagar.me, de acordo com o ambiente que você deseja usar, Live ou Test. Veja mais sobre essa chave em: [Chaves de acesso](https://docs.pagar.me/docs/api-key-e-encryption-key) * `Ativar split e enviar recebedores`: Define se você terá split habilitado ou não no Conector. Para habilitar essa funcionalidade, preencha com `Sim`. Se desejar desligar a opção, basta trocar para `Não`. **Para os campos abaixo, existem 3 opções, sendo elas**: `Marketplace`, `Markeplace + Sellers` e `Sellers` *Marketplace*: Se refere ao lojista. *Sellers*: Se refere aos vendedores do produto. *Marketplace + Sellers*: Se refere ao lojista e aos vendedores do produto. * `Responsabilidade pelas tarifas de pagamento`: Define o responsável pelas [taxas da transação](https://pagarme.zendesk.com/hc/pt-br/articles/115000530746-Quem-arca-com-as-taxas-em-uma-regra-de-split-). * `Responsabilidade pelos chargebacks`: Define o responsável caso a transação sofra um [chargeback](https://pagarme.zendesk.com/hc/pt-br/articles/204767349-O-que-%C3%A9-chargeback-). Você pode ter mais informações sobre como configurar a divisão de tarifas, e responsáveis pelo chargeback clicando [aqui](https://docs.pagar.me/v1/docs/split-rules#section-par%C3%A2metros-de-uma-split-rule). Exemplos de configuração: * Se no campo `Responsabilidade pelas tarifas de pagamento` escolher por `Marketplace`, e no campo `Responsabilidade pelos chargebacks` escolher `Sellers`, as transações de split terão os custos das tarifas de split aplicadas somente para o Marketplace (no caso a loja em si), e os custos em caso de chargeback serão exclusivos dos Sellers na plataforma. * Se no campo `Responsabilidade pelas tarifas de pagamento` escolher por `Marketplace + Sellers`, e no campo `Responsabilidade pelos chargebacks` escolher `Marketplace + Sellers`, as transações de split terão os custos das tarifas de split e os custos em caso de chargeback compartilhados entre Marketplace e Sellers. **Importante** Existe também a responsabilidade sobre o resto da divisão das taxas no split de transação, caso a divisão tenha um resto a ser cobrado. Na integração do split Pagar.me na plataforma VTEX, essa responsabilidade será sempre atribuída ao primeiro recebedor (seja Seller ou Marketplace) enviado pela plataforma VTEX e que seja configurado como responsável pelas tarifas de pagamento. Exemplo: * Se no campo `Responsabilidade pelas tarifas de pagamento` for escolhida a opção `Marketplace` ou `Marketplace + Sellers`, o Marketplace será o responsável pelo resto da divisão da tarifa. * Se no campo `Responsabilidade pelas tarifas de pagamento` for escolhida a opção `Sellers`, o primeiro Seller enviado pela plataforma VTEX será o responsável pelo resto da divisão da tarifa. **Configurando as formas de pagamento** Após configurar o conector `PagarMeV2`, você deve atrelá-lo à formas de pagamento que realizarão a divisão da transação. Para aprender a configurar as formas de pagamento, você pode acessar esse [link](https://docs.pagar.me/v1/docs/configurando-o-m%C3%B3dulo-pagarme-na-plataforma-vtex#section-configura%C3%A7%C3%A3o-por-bandeira). Uma vez configurada corretamente, sua loja está pronta para operar o split de pagamento! :D ## Como conferir o resultado do split na vtex Uma vez criado o pagamento com divisão de transação, você pode conferir os pedidos diretamente no OMS da sua loja VTEX. Haverá um pedido para cada Seller presente na venda. Note que a coluna *Origem* vai exibir `Marketplace` para pedidos realizados com split de transação. ![Página de pedidos na VTEX](https://i.imgur.com/6kSr9IH.png) ## Como conferir o resultado do split na Pagar.me. Ao criar um pedido com divisão de transação, você pode identificar a regra de divisão tanto pela dashboard como pela nossa API. Para isso, você deve seguir estes passos: ### Pela dashboard do Pagar.me 1. **Obtenha o ID da transação na loja VTEX**. Você pode fazer isso pelo PCI Gateway da sua loja VTEX, acessando pelo caminho `Pagamentos > Transações`. Clique na transação desejada. Uma vez na tela da transação, clique no link *Informações* para obter o ID da transação do Pagar.me. ![Obtendo ID da transação pela transação](https://i.imgur.com/HdymhVM.gif) Você pode também obter o ID da transação do Pagar.me pela tela do pedido, clicando no link *Ver detalhes da transação* no canto superior direito da tela: ![Obtendo ID da transação pelo pedido](https://i.imgur.com/7WfzutS.gif) 2. **Pesquise pela transação na dashboard do Pagar.me** Uma vez com o ID da transação do Pagar.me em mãos, você pode buscar os detalhes da transação pela nossa dashboard. Ao criar um pedido com divisão de transação, você pode identificar a regra de divisão pela dashboard. Para isso, você deve seguir estes passos: ![Consultando Split na Dashboard](https://i.imgur.com/774viGN.gif) ## Como cadastrar a conta bancária desse Seller/Recebedor Ao cadastrar seus vendedores na VTEX, você habilitará que eles vendam utilizando sua plataforma de Marketplace, porém suas contas para recebimento não estarão cadastradas no Pagar.me. Para cadastrar, acesse a [dashboard](https://dashboard.pagar.me) e vá para `Ver minha conta > Configurações > Contas Bancárias`, e então clique em `Adicionar conta bancária`. ![Criando uma conta bancária](https://i.imgur.com/ZWKxpHd.png) Após isso, será necessário vincular essa conta bancária ao recebedor. Você pode fazer isso pela própria [dashboard](https://dashboard.pagar.me), basta seguir os passos abaixo: 1. Para obter o ID do seller da VTEX, há duas condições:\ 1.1. Se o recebedor for um Seller na sua loja VTEX, siga até `Sellers > Gerenciamento` e pegue o valor da coluna *ID do Seller*.\ 1.2. Se o recebedor for o Marketplace (a sua loja), pegue o nome da loja descrito no canto superior esquerdo da sua loja VTEX. ![Obtendo ID do Seller na VTEX](https://i.imgur.com/cN1Y5t2.png) 2. Agora, acesse sua Dashboard do Pagar.me pelo caminho `Ver minha conta > Configurações > Recebedores`. 3. No campo de pesquisa, insira o ID Externo do Recebedor (podendo ser o ID do Seller ou o nome da loja) obtido na sua loja VTEX. ![Filtrar recebedor](https://i.imgur.com/Q03ppcP.png) 4. Uma vez encontrado, clique para editar os dados desse Recebedor. ![Editando um recebedor no Pagar.me](https://i.imgur.com/oVbet52.png) 5. Após isso, basta atrelar a conta bancária criada à este recebedor. ![Atrelando uma conta bancária à um recebedor](https://i.imgur.com/Sp92fjP.png) **Importante** A conta bancária deve ter o mesmo número de documento do recebedor. Este documento é o mesmo que o vendedor tem cadastrado em sua loja. ## Como efetuar o saque para um seller Para retirar o dinheiro da conta de recebedores, é preciso efetuar o saque. Para fazer isso, siga os passos pela dashboard do Pagar.me, conforme instruções [neste link](https://docs.pagar.me/docs/saque) da nossa documentação.