Split para Magento 2 (Adobe Commerce)

Agora vamos falar sobre as funcionalidades de Split de pagamentos para marketplace do nosso módulo Magento 2. Se você quer saber mais sobre tudo que a Pagar.me pode lhe oferecer em termos de Split de pagamentos, recomendamos a leitura da seção Overview Marketplace da nossa documentação.

Por aqui iremos focar somente nas funcionalidades do nosso módulo Magento 2.

Requisitos adicionais

Além dos requisitos de nosso módulo apresentados anteriormente, a funcionalidade de Marketplace precisa dos seguintes requisitos adicionais:

  • Em sua conta Pagar.me:
    • Modelo de negócio configurado como PSP;
    • Funcionalidade Split ativa;
  • Utilização do módulo Marketplace Multi Vendor Module for Magento 2 da Webkul para o gerenciamento de seus recebedores. Ou desenvolvimento próprio equivalente, mais informações abaixo em Gestão de recebedores.

Funcionalidades da solução

Com nossa solução de Marketplace você será capaz de:

  • Criar pedidos com split de pagamentos
    • Sem limite de recebedores por carrinho
    • Com itens de recebedores diferentes e sem recebedor num mesmo carrinho
  • Cancelamento total e parcial de pedidos com split
  • Captura manual e automática de pedidos com split
  • Utilizar multimeios de pagamento em pedidos com split
  • Utilizar multicompradores em pedidos com split
  • Configurar suas regras de split da forma que faz mais sentido para seu negócio
  • Cadastrar recebedores Pagar.me de dentro da plataforma

Configurações de Marketplace

Primeiramente vamos falar sobre as configurações gerais necessárias para o módulo funcionar com split.

Para acessar as configurações do módulo você deve se direcionar ao itemPagar.me, no final do menu lateral esquerdo, selecionar a opção Configuration dentro da subcategoria Payment Methods. Nesta página de configurações, mais para baixo, você irá encontrar a aba Pagar.me - Payment Solutions escolha a opção Marketplace, onde poderá começar a configuração de seu módulo.

Explicando os campos da seção:

CampoPadrãoDescrição
Enable this solutionNoAtiva ou desativa a opção de oferecer pagamentos com split pelo módulo.
Responsibility for processing feesMarketplace and sellersDefine o responsável por pagar as taxas de processamento do pedido. Mais informações aqui.
Responsibility for chargebacksMarketplace and sellersDefine o responsável por arcar com o prejuízo caso o pedido sofra um chargeback. Mais informações aqui.
Responsibility for receiving split remainderMarketplace and sellersDefine o responsável por receber os eventuais restos de divisão que podem ocorrer durante o Split do pagamento. Mais informações aqui.
Responsibility for receiving extras and discountsMarketplace and sellersDefine o responsável por receber os valores extras do pedido, ou seja, valores que são acréscimos ou descontos sobre o valor dos itens. P.ex.: O valor do frete, os juros do parcelamento de cartão, cupons de desconto, entre outros.
Marketplace main recipient
Obrigatório
--Campo onde deve ser inserido o id do recebedor que será interpretado por nosso módulo como sendo o Marketplace (recebedor principal). Isso significa que será no saldo deste recebedor que serão creditados os valores de comissão.
  1. Onde os campos "Responsibility" tem as seguintes opções de preenchimento:
  • Marketplace: Onde somente o recebedor referente ao Marketplace será responsável/receberá os valores referentes a essa configuração;
  • Marketplace and sellers: Onde todos os recebedores (incluindo o Marketplace) envolvidos no pedido serão responsáveis/receberão os valores referentes a essa configuração. Sendo essa distribuição feita de forma proporcional aos seus valores no split (valor do recebedor X/valor total do pedido);
  • Sellers: Onde todos os recebedores envolvidos no pedido, excluindo o recebedor referente ao Marketplace, serão responsáveis/receberão os valores referentes a essa configuração. Sendo essa distribuição feita de forma proporcional aos seus valores no split (valor do recebedor X/valor total do pedido).
  1. Ao finalizar a determinação de cada campo, e após preencher o Marketplace main recipient, você deve clicar no botão Get info que preencherá automaticamente os demais campos de informações sobre o recebedor.

Pedidos com split

Uma vez configurado nosso módulo e cadastrados os produtos e recebedores de seu Marketplace, você já pode começar a criar seus pedidos com Split.

Nosso módulo realiza o split automaticamente. Assim que o botão de realizar pagamento for pressionado, nosso módulo irá:

  1. Buscar no Magento 2 por todos os itens do pedido.
  2. Buscar em cada um desses produtos pelo ID interno do recebedor responsável e sua respectiva taxa de comissão.
  3. Buscar o ID Pagar.me correspondente a cada um dos recebedores envolvidos.
  4. Calcular o valor a receber referente a cada recebedor.
  5. Montar e enviar a requisição de criação do pedido com as regras de split.

Com isso seu pedido será criado seguindo os fluxos transacionais de nossa API e os valores a receber de cada recebedor serão creditados no saldo Pagar.me de cada um, podendo ser antecipados ou sacados conforme os prazos de recebimento.

Recebedores internos (Sellers)

Para o nosso módulo existem dois conceitos de recebedor: o recebedor interno, que faz parte da gestão de produtos e vendas de dentro do Magento; e o recebedor Pagar.me, que se refere ao recebedor que foi cadastrado dentro do ambiente Pagar.me onde serão realizadas as operações financeiras do mesmo.

Com essa distinção nós conseguimos ter toda a customização do ambiente Magento, para poder criar e gerir seus recebedores da melhor forma para seu negócio. Ainda podendo utilizar de um fluxo simples para criar seus pedidos com as informações necessárias dentro da API Pagar.me. Sendo que para isso criamos uma página dedicada a vincular essas duas entidades dentro do Magento.

Cadastro de recebedores Pagar.me

Nosso módulo possui uma página de cadastro de recebedores, é nela que você irá selecionar os sellers internos e vinculá-los a um recebedor Pagar.me, novo ou que já tenha sido criado.

Para tal, você precisará acessar o menu lateral esquerdo no item Pagar.me, após, selecione a opção Marketplace dentro da subcategoria Recipients. Nesta página, acione o botão Add a new recipient e pronto! De forma rápida você terá concluído o vínculo e o seller estará pronto para transacionar.

Informações do recebedor

CampoPadrãoDescrição
Select seller
Obrigatório
--Lista com todos os sellers (recebedores internos) cadastrados no Magento que podem ser usados para vincular a um recebedor Pagar.me.
Use a existing Pagar.me recipient
Obrigatório
NoCampo True ou False, que define se o módulo irá criar um recebedor Pagar.me novo ou utilizar um já cadastrado.
ID Pagar.me
Obrigatório
--Campo onde deve ser inserido o id do recebedor Pagar.me que será vinculado àquele recebedor interno.

Informações Bancárias

CampoPadrãoDescrição
Holder name
Obrigatório
--Nome do titular da conta.
Document type
Obrigatório
CPFTipo de documento identificador do titular da conta. Valores possíveis CPF ou CNPJ.
Document number
Obrigatório
--Número do documento identificador do titular da conta (CPF ou CNPJ).
Bank code
Obrigatório
--Código do banco. Deve conter apenas 3 caracteres, apenas números.
Branch number
Obrigatório
--Agência onde sua conta foi criada. Limite de 4 caracteres, apenas números.
Branch check digit--Dígito verificador da sua agência. Deve conter 1 caractere, campo alfanumérico.
Account number
Obrigatório
--Número da conta bancária. Limite de 13 caracteres, apenas números.
Account check digit
Obrigatório
--Dígito verificador da conta. Limite de 2 caracteres, campo alfanumérico.
Account type
Obrigatório
CheckingTipo de conta bancária. Valores possíveis: "checking" (conta corrente) ou "savings" (conta poupança).

Informações de transferência

CampoPadrãoDescrição
Enable automatic transfer
Obrigatório
NoAtiva ou desativa a função de transferência automática. Mais informações aqui.
Transfer interval
Obrigatório se Enable automatic transfer = Yes
DailyIndica a frequência na qual o recebedor irá ser pago. Valores possíveis: daily, weekly, monthly.
Transfer day
Obrigatório se Enable automatic transfer = Yes
0Indica o dia no qual o recebedor vai ser pago. Depende do transfer_interval. Se for daily, não é necessário. Se for weekly pode ser de 1 (segunda) a 5 (sexta). Se for monthly, pode ser de 1 a 31.

Gestão de recebedores

Atualmente, o escopo de nosso módulo se limita a criação de pedidos com split e dos recebedores Pagar.me, necessários para a criação desses pedidos. Não possuindo funcionalidades ligadas a gestão dos recebedores (sellers), por exemplo, o cadastro de produtos para cada recebedor, configuração de comissões, páginas de extrato, inventário, vendas, entre outras.

Especificamente para nosso módulo, a configuração das comissões de cada recebedor é essencial para seu funcionamento, e por tanto se faz necessário um módulo terceiro ou um desenvolvimento externo para implementar essa funcionalidade.

Para isso, decidimos por utilizar o módulo Marketplace Multi Vendor Module for Magento 2 da Webkul para fazer essa compatibilização.

Ou seja, nesse primeiro momento, existem duas formas de fazer com que sua integração com nossa solução de Marketplace funcione corretamente. Você pode utilizar o módulo Webkul, cuja compatibilização já foi feita; ou então investir num desenvolvimento externo para compatibilizar nosso módulo com outra forma de gestão de recebedores.

❗️

Recorrência com Split

Nosso módulo ainda não é capaz de criar pedidos de recorrência com Split de pagamentos. Caso pretenda utilizar ambas funcionalidades na mesma loja, é importante que produtos split e produtos recorrêntes não sejam adicionados ao mesmo carrinho pois, nesse caso, o Split de pagamento será descartado.