Split de pagamentos Magento 2
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:
Campo | Padrão | Descrição |
---|---|---|
Enable this solution | No | Ativa ou desativa a opção de oferecer pagamentos com split pelo módulo. |
Responsibility for processing fees | Marketplace and sellers | Define o responsável por pagar as taxas de processamento do pedido. Mais informações aqui. |
Responsibility for chargebacks | Marketplace and sellers | Define o responsável por arcar com o prejuízo caso o pedido sofra um chargeback. Mais informações aqui. |
Responsibility for receiving split remainder | Marketplace and sellers | Define 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 discounts | Marketplace and sellers | Define 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 recipientObrigató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. |
- 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).
- Ao finalizar a determinação de cada campo, e após preencher o
Marketplace main recipient
, você deve clicar no botãoGet 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á:
- Buscar no Magento 2 por todos os itens do pedido.
- Buscar em cada um desses produtos pelo ID interno do recebedor responsável e sua respectiva taxa de comissão.
- Buscar o ID Pagar.me correspondente a cada um dos recebedores envolvidos.
- Calcular o valor a receber referente a cada recebedor.
- 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
Campo | Padrão | Descrição |
---|---|---|
Select sellerObrigató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 recipientObrigatório | No | Campo True ou False, que define se o módulo irá criar um recebedor Pagar.me novo ou utilizar um já cadastrado. |
ID Pagar.meObrigatório | -- | Campo onde deve ser inserido o id do recebedor Pagar.me que será vinculado àquele recebedor interno. |
Informações Bancárias
Campo | Padrão | Descrição |
---|---|---|
Holder nameObrigatório | -- | Nome do titular da conta. |
Document typeObrigatório | CPF | Tipo de documento identificador do titular da conta. Valores possíveis CPF ou CNPJ. |
Document numberObrigatório | -- | Número do documento identificador do titular da conta (CPF ou CNPJ). |
Bank codeObrigatório | -- | Código do banco. Deve conter apenas 3 caracteres, apenas números. |
Branch numberObrigató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 numberObrigatório | -- | Número da conta bancária. Limite de 13 caracteres, apenas números. |
Account check digitObrigatório | -- | Dígito verificador da conta. Limite de 2 caracteres, campo alfanumérico. |
Account typeObrigatório | Checking | Tipo de conta bancária. Valores possíveis: "checking" (conta corrente) ou "savings" (conta poupança). |
Informações de transferência
Campo | Padrão | Descrição |
---|---|---|
Enable automatic transferObrigatório | No | Ativa ou desativa a função de transferência automática. Mais informações aqui. |
Transfer intervalObrigatório se Enable automatic transfer = Yes | Daily | Indica a frequência na qual o recebedor irá ser pago. Valores possíveis: daily , weekly , monthly . |
Transfer dayObrigatório se Enable automatic transfer = Yes | 0 | Indica 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.
Updated 6 months ago