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.