Split de pagamento no WooCommerce

Use o Split de pagamento para distribuir automaticamente parte dos valores das vendas entre outras carteiras Asaas.

No Plugin Asaas para WooCommerce, a configuração é associada às novas cobranças criadas pelo plugin. Não é necessário definir o Split em cada pedido.

Antes de começar

Antes de configurar:

• conecte o Plugin Asaas à sua conta;
• utilize uma versão do plugin compatível com Split;
• confirme que cada recebedor possui uma conta Asaas;
• obtenha o walletId das contas que receberão os repasses;
• defina como o valor será distribuído;
• utilize o Sandbox para validar a configuração antes de operar em Produção.

Não informe como recebedor o walletId da própria conta que cria a cobrança. O valor líquido não distribuído permanece nessa conta.

O Split percentual é calculado sobre o valor líquido da cobrança (netValue), após as taxas aplicáveis.

Consulte as regras gerais do Split de pagamento.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Configurar o Split"] --> B["Cliente realiza a compra"]
    B --> C["Plugin cria a cobrança com Split"]
    C --> D["Cliente realiza o pagamento"]
    D --> E["Calcular o valor líquido"]
    E --> F["Liquidar os Splits"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px

    class A inicio
    class B,C,D,E validacao
    class F sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

A configuração de Split é enviada pelo plugin durante a criação da cobrança. Após o recebimento, o Asaas calcula e processa os repasses conforme a regra vinculada.

1. Acesse a configuração do Split

No WordPress, acesse:

WooCommerce > Configurações > Pagamentos

Selecione uma das formas de pagamento do Asaas e localize a seção Split.

2. Configure os recebedores

Defina as carteiras que receberão parte dos valores e a regra de distribuição utilizada pela operação.

Antes de salvar, confirme:

• se os walletId pertencem aos recebedores esperados;
• se nenhum recebedor utiliza o walletId da própria conta emissora;
• se os valores distribuídos são compatíveis com o valor líquido disponível;
• se a distribuição corresponde à regra comercial da operação.

Salve as alterações após revisar a configuração.

3. Entenda quando a alteração será aplicada

A configuração vale para novas cobranças criadas pelo Plugin Asaas.

Alterar o Split:

• modifica as cobranças criadas após a mudança;
• não altera cobranças que já existem;
• não recalcula Splits vinculados a pedidos anteriores.

4. Valide no Sandbox

Crie uma compra utilizando uma das formas de pagamento habilitadas e confirme se:

1. a cobrança foi criada no Asaas;
2. os recebedores esperados estão vinculados ao Split;
3. os valores correspondem à regra configurada;
4. após o pagamento, os Splits são processados conforme esperado.

Resultado esperado

As novas cobranças do Plugin Asaas devem ser criadas com a configuração de Split definida e, após o recebimento, os valores devem ser distribuídos entre as carteiras configuradas.

Para uma conferência operacional, consulte os Splits pagos e recebidos na interface do Asaas.

Consulte os Splits pela interface.

Acompanhe a liquidação

Para acompanhamento automatizado do Split em uma integração própria, utilize o evento:

PAYMENT_SPLIT_DONE

O evento é disparado quando um Split específico é liquidado. Quando uma cobrança possui mais de um recebedor, podem ocorrer vários eventos, um para cada Split liquidado.

Utilize Webhooks para esse acompanhamento em vez de consultas periódicas.

Consulte os eventos para cobranças.

Próximos passos

• Consulte as regras do Split de pagamento
• Configure as formas de pagamento
• Consulte os Splits pela interface
• Acompanhe os eventos para cobranças
• Consulte os erros comuns do WooCommerce