--- title: "VTEX Sellers - Marketplace (legado)" url: "https://devcenter.stone.com.br/legacy-vtex-sellers-marketplace" image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_VTEX+Sellers+-+Marketplace+(legado),props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktdnRleC1zZWxsZXJzLW1hcmtldHBsYWNlIg,s_cfjGHyk_wOSy_eeY.png" --- # VTEX Sellers - Marketplace APP adicional para administração dos vendedores do Marketplace VETEX Documentação legada do Pagar.me v5 Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**. APP adicional para administração dos vendedores do Marketplace VETEX ## [Introdução](#introdução) Para os clientes que utilizam o Conector VTEX V3 e são Marketplaces, contamos com um APP extra, o VTEX Sellers. Este aplicativo deve ser utilizado para administração de seus vendedores, fazendo a comunicação de forma prática entre a base da VTEX e do Pagar.me para processamento de [Split de Pagamentos](https://docs.pagar.me/docs/pedidos-com-split). ### [Requisitos](#requisitos) - **Conta** Pagar.me com modelo de negócio **PSP** - **Conector PagarMeV3** na sua loja VTEX ### [Vendedores](#vendedores) O Marketplace é composto por diversos vendedores que se cadastram no site e são comissionados pelas vendas. Essa é a forma como ele é visto por cada player: | Entidade | VTEX | Pagar.me | | :------------- | :------------------------------ | :------------------------------------------ | | Vendedor | Seller | Recebedor | | ID do vendedor | Customizável conforme critérios | Padrão: re_xxxxxxxxxxxx ou rp_xxxxxxxxxxxxx | Na prática, **todo Seller VTEX deve ser vinculado a um Recebedor Pagar.me equivalente** para transacionar. ## [Funcionalidades](#funcionalidades) - **Listagem completa de vendedores:** detalhamento de informações do Seller VTEX, Recebedor Pagar.me equivalente e status para transacionar - **Vínculo automático:** crie um novo recebedor Pagar.me para um Seller já existente da VTEX - **Vínculo manual:** apenas vincule manualmente um recebedor já existente no Pagar.me a um Seller também já existente na VTEX - **Desvínculo:** caso necessário, você consegue desfazer a relação já existente entre um Sellex VTEX com um Recebedor Pagar.me, dessa forma, posteriormente esse Seller poderá ser vinculado a outro Recebedor Pagar.me ## [Instalando o VTEX Sellers](#instalando-o-vtex-sellers) Para facilitar o processo esteja logado em sua [Dashboard](https://id.pagar.me/signin) do Pagar.me e na sua loja VTEX. Vamos ao passo a passo: 1. Em sua loja VTEX, na url do site, acrescente a informação: **`apps/pagarme.pagarme-sellers@1.1.0/setup`** Exemplo: _`https://[SUALOJA].myvtex.com/admin/apps/pagarme.pagarme-sellers@1.1.0/setup`_\\ 2. Após ser encaminhado ao APP na loja VTEX, clique em **Instalar**\\ 3. Recarregue a página clicando em **F5** Pronto, o APP foi instalado com sucesso! Vamos seguir a próxima etapa. ### [Integrando o VTEX Sellers ao Pagar.me](#integrando-o-vtex-sellers-ao-pagarme) Agora que o APP está instalado em sua loja, precisamos conectá-lo ao Pagar.me, vamos lá: 1. No menu lateral esquerdo clique em **Aplicativos > Pagarme Sellers**\\ 2. Após clique no botão **Integrar com Pagar.me**\\ 3. Você será direcionado ao HUB Pagar.me onde deve **indicar a loja que deseja utilizar**: ![](https://files.readme.io/a8743dd6b798edd27d75557e4c18d0e8bf26f8b24890ac70c798c13c37bfbdc4-POWERPNT_6GPvgpJMCz.png) 4. Após selecionada a loja, finalize clicando em **Instalar APP** Feito! Agora os vendedores serão listados e poderão ser gerenciados diretamente em seu site. ## [Gestão de vendedores](#gestão-de-vendedores) Você já deve ter acesso à listagem completa de vendedores, conforme abaixo: ![](https://files.readme.io/2ec135f97e01c06286951119220c2f56c99e8f2827b5739a5185db5be3447b89-POWERPNT_EnWkmqsNRh.png) Essa tabela irá indicar sempre o Seller VTEX e seu Recebedor Pagar.me equivalente, caso não exista vínculo do Seller com o Recebedor, o campo fica em branco ("--------"). ### [Ações](#ações) #### [Vincular](#vincular) Existem duas possibilidades para vínculo de um Seller VTEX a um Recebedor Pagar.me, eles se revelam ao clicar no botão **Vincular** da listagem: ![](https://files.readme.io/3a8fbf7761e10ef2e22db4c7050ef1c1099bc5689cac8bade1be5e8b03ed8823-chrome_OuRVLDXdxr.png) #### [Vínculo automático: Criar novo recebedor Pagar.me](#vínculo-automático-criar-novo-recebedor-pagarme) Neste fluxo, você será encaminhado a uma página de formulário onde deve preencher todos os dados do vendedor (conforme etapas à direita). Após a conclusão, o Seller VTEX será vinculado automaticamente a um novo Recebedor Pagar.me que será criado ao clicar no botão **Salvar**. ![](https://files.readme.io/e7a01d75c987fc33d90bb82a0822cec498b599c7489877996e4f53dc957d29fd-chrome_vDzEHlgPb3.png) Em seguida, você será encaminhado a listagem, onde o vínculo estará estabelecido! Adequações Bacen Todo o formulário que coleta as informações para criação de recebedores já está adaptado segundo as diretrizes regulatórias do Bacen para Markeplaces, mais informações [aqui](https://docs.pagar.me/page/adequa%C3%A7%C3%A3o-de-marketplace-para-mudan%C3%A7as-regulat%C3%B3rias). #### [Vínculo manual: Vincular a um recebedor Pagarme já existente](#vínculo-manual-vincular-a-um-recebedor-pagarme-já-existente) Este segundo fluxo será utilizado caso já exista um Recebedor Pagar.me criado anteriormente com os dados do Seller VTEX e você só precise estabelecer o vínculo entre eles. 1. Preencha o **ID do Recebedor Pagar.me** desejado e clique em **Avançar**: ![](https://files.readme.io/02a3cff209431769897ddf8b5ba7ea3ca3572eef3c7ddf5a5677288b4b8e0b82-chrome_Y8kz8736SC.png) 2. Confira os dados e finalize clicando em **Continuar**: ![](https://files.readme.io/79a4d2f97d74b78948aedf6c6e5c4bd62130f4afa9b89f58132d8a6eb1df00a0-Photos_KvQIpGrhtc.png) Em seguida, você será encaminhado para uma página de sucesso e então à listagem, onde o vínculo estará estabelecido! #### [Desvincular](#desvincular) Caso possua um Seller VTEX vinculado a um Recebedor Pagar.me, mas por algum motivo precisar desfazer essa relação, basta seguir da seguinte forma: 1. Localize o vendedor que deseja realizar o desvínculo na listagem e clique na **setinha para ver detalhes**: ![](https://files.readme.io/ca8b40fa01f72a7bc92963b59795bd05ebf8dbc3fc26abb36b4d3f81be8ef3e6-chrome_HiI8MgXTxg.png) 2. Em seguida clique em **Desvincular > Confirmar**: ![](https://files.readme.io/f56c126be24c14ddb7b87d9456c90d1319ffb4cd9c72a54c4800981580278e57-Photos_5wj75znI2O.png) Você será encaminhado para uma página de sucesso e então à listagem, onde o desvínculo será evidenciado. O botão de Vincular ficará disponível novamente para um vínculo futuro. ## [Utilização em múltiplas contas Pagar.me](#utilização-em-múltiplas-contas-pagarme) Quando o aplicativo VTEX Sellers é instalado, ele sempre é vinculado a uma única conta Pagar.me após sua instalação e integração com o hub, conforme o [tutorial de instalação acima](https://devcenter.stone.com.br/legacy-vtex-sellers-marketplace#instalando-o-vtex-sellers). ![](https://files.readme.io/b334efbf41bbd2eb3225f37b329107f1d82f19d00a671dda81cd144072a955cb-0F86CBFF-D212-4EDE-9A99-D3F783F6891E.png) Entretanto, em alguns cenários avançados, podemos ter em uma mesma conta VTEX mais de uma conta da Pagar.me configurada. Caso seja necessário fazer a gestão dos sellers de mais de uma conta, o caminho é utilizar a [funcionalidade de múltiplas lojas da VTEX](https://help.vtex.com/pt/tutorial/account-details-page--2vhUVOKfCaswqLguT2F9xq#lojas) para fazer instalações adicionar do nosso aplicativo VTEX Sellers. Quando é feita uma instalação de um aplicativo na VTEX, ele é instalado apenas em uma loja específica e não na conta inteira. O VTEX Sellers não irá aplicar os vínculos feitos apenas para a loja VTEX específica e sim para toda a conta VTEX. Para mais informações sobre a [gestão de múltiplas lojas, consulte a central de ajuda da VTEX](https://help.vtex.com/pt/tutorial/account-details-page--2vhUVOKfCaswqLguT2F9xq#lojas). Ou seja, você pode tanto criar uma nova loja para fazer a instalação do aplicativo, como também utilizar uma loja já existente ou até mesmo [workspaces se você for um usuário avançado de VTEX IO](https://learn.vtex.com/docs/course-content-workflow-step01workspaces-lang-pt). ### [Fazendo a instalação em múltiplas lojas](#fazendo-a-instalação-em-múltiplas-lojas) #### [1 - Defina a loja que será feita a instalação](#_1-defina-a-loja-que-será-feita-a-instalação) Consulte as lojas já criadas dentro da VTEX ou crie uma nova loja. [Confira mais detalhes na central de ajuda da VTEX sobre múltiplas lojas](https://help.vtex.com/pt/tutorial/account-details-page--2vhUVOKfCaswqLguT2F9xq#lojas). ![](https://files.readme.io/d6eff41fb96b3b2e7f5cd87f820c29524acafd62a4ad7a8760e65f4e95583b5d-image.png) #### [2 - Acesse o ambiente da loja que deseja fazer a instalação](#_2-acesse-o-ambiente-da-loja-que-deseja-fazer-a-instalação) Para acessar a loja, utilize o seletor no topo do admin da VTEX ou acesse a URL do admin diretamente através de https://\[NOME\_DA\_LOJA\].myvtex.com/admin ![](https://files.readme.io/d7c948e1322ffc260087aa7ecaa449e308e821db4d7cc2d3f7d775c0fdae6990-B04B02A6-07C7-4C01-847F-815262A3772F.png) #### [3 - Instalação do VTEX Sellers](#_3-instalação-do-vtex-sellers) Siga os passos do [tutorial de instalação acima, para instalar na loja a conta Pagar.me adicional](https://devcenter.stone.com.br/legacy-vtex-sellers-marketplace#instalando-o-vtex-sellers). Você pode fazer este processo em quantas contas desejar, sempre fazendo um link de conta Pagar.me por loja na VTEX. --- **Jornada: [Conectar minha plataforma de e-commerce](https://devcenter.stone.com.br/legacy-plataformas)** Etapa 14 de 26 [**Etapa anterior**VTEX: Funcionalidades](https://devcenter.stone.com.br/legacy-ativacao-funcionalidades-vtex)[**Próxima etapa**VTEX: Cartão private label](https://devcenter.stone.com.br/legacy-cadastrando-cartao-private-label) Siga a Stone nas redes sociais [](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ) © Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57 Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.