Nossa integração PagBank Connect para WooCommerce possui integração nativa com o plugin de marketplace Dokan.
Isso quer dizer que pagamentos feitos em sua loja podem automaticamente ser divididos entre o marketplace e múltiplos vendedores, com suas respectivas contas PagBank.
Pré-requisito
Sua Connect key deve ter sido obtida após 17 de Novembro de 2025. Caso contrário você deve obter uma nova para usar o split de pagamento.
Como habilitar
Acesse PagBank > Configurações e clique na aba Integrações.
Depois ative a opção Ativar split de pagamento para vendedores Dokan e realize as configurações adicionais necessárias.
Account ID para vendedores e administradores
Os vendedores, por sua vez, poderão configurar o account ID do PagBank navegando até o dashboard do vendedor > settings > store.
Os vendedores podem cadastrar o PagBank account ID, porém não podem alterá-lo. Isto é feito somente pelo administrador do marketplace, indo até os detalhes do usuário (em Usuários > Todos Usuários).
Quem assume as taxas do PagBank?
Sempre o recebedor primário (marketplace), por uma limitação do próprio PagBank.
Repasse para o vendedor
O valor de uma venda com split de pagamentos ficará retido até o prazo de custódia especificado nas configurações do plugin, ou até o pedido ser marcado como concluído pelo vendedor.
Responsabilidade por Chargebacks + Liable
Pode ser configurada de 2 formas diferentes:
Por uma limitação do PagBank somente um recebedor pode ficar responsável pelo chargeback. Por padrão (Automático), sempre que houver apenas um vendedor (além do próprio marketplace) ele será o responsável por chargebacks.
Da mesma forma o liable. A funcionalidade de Liable, exclusiva para a funcionalidade de divisão de pagamentos PagBank, é utilizada para designar o vendedor recebedor principal da transação para as bandeiras de cartão de crédito, como Visa, Mastercard, Elo, etc.. O uso dessa funcionalidade é recomendado pelas bandeiras. Quando um vendedor recebedor é definido como Liable, os dados desse vendedor são repassados para as bandeiras de cartão, substituindo os dados do vendedor primário (usuário PagBank). Esses dados incluem MCC, endereço, ID e CNPJ/CPF, todos provenientes da conta do vendedor no PagBank. Mais detalhes na documentação oficial.
Limitações e incompatibilidades
3DS Authentication e Split com Liable
IMPORTANTE: A autenticação 3DS (Three Domain Secure) NÃO é compatível com transações de split que utilizam a configuração liable.
O que acontece:
- ✅ Se houver split de pagamento configurado para o pedido, o 3DS será automaticamente desabilitado
- 📝 Um log será gerado:
"3DS authentication skipped for order X due to split transaction with liable configuration" - ⚠️ Caso o 3DS seja enviado junto com split+liable, o PagBank retornará erro:
"3DS AUTHENTICATION IS NOT VALID METHOD FOR SPLIT TRANSACTIONS WITH LIABLE CONFIGURATION"
Por quê? Esta é uma limitação da API do PagBank. Transações com split que utilizam o recurso liable (responsabilidade do vendedor) não podem utilizar autenticação 3DS simultaneamente.
Impacto:
- Transações com split de pagamento não terão a camada adicional de segurança do 3DS
- A taxa de aprovação pode ser ligeiramente diferente (geralmente sem impacto significativo)
- A responsabilidade por chargebacks segue as regras definidas na configuração do split
Taxas de Gateway
IMPORTANTE: As taxas do PagBank são sempre pagas pelo vendedor primário (marketplace).
O que isso significa:
- ✅ O marketplace é sempre responsável pelas taxas de transação do PagBank
- ✅ Esta é uma limitação da API do PagBank, não há como configurar de outra forma
- ℹ️ As taxas são deduzidas do valor total antes de realizar o split para os vendedores
- ⚠️ O marketplace deve considerar essas taxas ao definir suas comissões
Divisão de pagamento comum (sem marketplace)
Também é possível especificar vendedores/contas PagBank fixas para receber um % em todas as transações, sem necessidade de plugins adicionais.
Veja mais sobre o recurso de Divisão (split) de pagamentos entre múltiplas contas PagBank.
Comentários
0 comentário
Por favor, entre para comentar.