Split na Pluga

Como utilizar o split de pagamentos de maneira simples através da Pluga

Configure Split na Pluga

Crie cobranças com Split no Asaas por meio de uma automação da Pluga, sem desenvolver uma integração própria.

A ferramenta de origem pode ser o Google Sheets ou outro sistema compatível com a automação escolhida.

Antes de começar

Tenha:

uma conta Asaas;
uma conta na Pluga;
uma ferramenta de origem para os dados da cobrança;
acesso à conta Asaas que criará as cobranças;
os recebedores e a regra de divisão definidos.

Na Pluga, o Split pode utilizar subcontas cadastradas ou walletId, conforme o modelo de automação escolhido.

Se utilizar walletId, consulte como recuperar o identificador da carteira.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 18,"rankSpacing": 24,"diagramPadding": 4,"padding": 7}}}%%
flowchart TD
    A["Preparar os dados"] --> B["Configurar o gatilho"]
    B --> C["Conectar o Asaas"]
    C --> D["Mapear a cobrança"]
    D --> E["Configurar o Split"]
    E --> F["Finalizar a automação"]
    F --> G["Criar cobrança de teste"]
    G --> H["Validar os repasses"]

    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,F,G validacao
    class H sucesso

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

1. Prepare a origem dos dados

Organize os dados necessários para criar a cobrança e configurar o Split.

Em uma planilha, por exemplo, você pode separar:

Grupo	Exemplos
Cliente	Nome, e-mail e telefone
Cobrança	Valor, vencimento e descrição
Split	Recebedor, tipo de divisão e valor

Inclua o walletId quando ele for utilizado para identificar o recebedor.

2. Configure a automação

No painel da Pluga:

crie uma nova automação;
escolha a ferramenta de origem, como Google Sheets;
selecione a planilha ou recurso que contém os dados;
defina o gatilho que iniciará a criação da cobrança.

Utilize um gatilho que só seja acionado quando todos os dados necessários estiverem preenchidos.

3. Conecte o Asaas

Selecione o Asaas como ferramenta de destino e escolha a ação de criação da cobrança.

Conecte a conta Asaas conforme o fluxo de autenticação apresentado pela Pluga.

❗️
Risco de segurança
Proteja a chave utilizada pela automação e não a exponha em planilhas, repositórios ou outros locais sem controle de acesso.

4. Mapeie os dados da cobrança

Associe os dados da ferramenta de origem aos campos utilizados na criação da cobrança.

Revise principalmente:

cliente;
valor;
vencimento;
forma de pagamento;
referência da venda, quando utilizada.

Os campos disponíveis podem variar conforme a ação e o modelo de automação selecionados na Pluga.

5. Configure o Split

Na opção Split de Pagamento, habilite a divisão do pagamento.

Escolha como identificar os recebedores:

subcontas já cadastradas; ou
walletId.

Depois, defina o valor destinado a cada recebedor como:

valor fixo; ou
percentual.

⚠️
Atenção
As regras gerais do Split continuam válidas para cobranças criadas pela Pluga.
O percentual é calculado sobre o valor líquido da cobrança, e o walletId da própria conta emissora não deve ser utilizado como recebedor.

Consulte as regras do Split de Pagamentos.

6. Finalize e teste a automação

Revise os mapeamentos e finalize a automação na Pluga.

Acione o gatilho com dados de teste e confirme se a cobrança foi criada no Asaas com os recebedores e valores esperados.

Resultado esperado

A Pluga cria a cobrança no Asaas com a configuração de Split definida na automação.

Após o recebimento, o Asaas processa os repasses conforme as regras da cobrança.

Acompanhe os Splits

Para validação operacional, consulte os Splits pagos e recebidos diretamente pela interface Asaas.

Consulte Splits pela interface.

Se sua operação precisar de acompanhamento automatizado, utilize os Webhooks de cobranças. O evento PAYMENT_SPLIT_DONE indica a liquidação de um Split específico.

Consulte os Eventos para cobranças.

Próximos passos

Updated 6 days ago

Did this page help you?