Pular para o conteúdo principal
Split de Pagamento

Como configurar o split de pagamento da Asaas por local (location)

Escrito por FullComm

Última atualização Há 12 dias

Com o split por location, cada pedido pago via Asaas tem o valor dividido automaticamente entre a sua conta e a conta Asaas da loja (location) que atendeu o pedido. Você define, para cada location, qual conta recebe e quanto do frete e dos itens vai para ela.

💡 Você não precisa usar subcontas Asaas. O recebedor de cada location pode ser qualquer conta Asaas: uma conta independente de um franqueado, de um parceiro ou de outra empresa do grupo. Basta ter o wallet id dela. Se preferir, também dá para criar subcontas Asaas direto pelo painel do OMS, sem sair da Shopify. Mostramos os dois caminhos abaixo.

🎥 Prefere vídeo?


Antes de começar

  • O app OMS + PDV instalado na sua loja Shopify.

  • Uma conta Asaas com a chave de API (em Asaas → Integrações → Chave de API). Use uma chave $aact_hmlg_... para testar em homologação ou $aact_prod_... para produção.

  • O arquivo Split.flow (anexo neste artigo) para ativar a automação no Shopify Flow.


Passo 1: Abra o Split de pagamento

No admin da Shopify, abra Apps → OMS + PDV → Split de pagamento e clique em Configurar no card da Asaas.

Split de pagamento

Passo 2: Informe o token principal e as formas de pagamento

  1. Em Novo token Asaas, cole a chave de API da sua conta Asaas principal.

  2. Em Formas de pagamento, liste as formas que passam pela Asaas com exatamente os mesmos nomes usados na Shopify, por exemplo PIX, Boleto e Cartão de crédito. Só os pedidos pagos com essas formas entram no split.

  3. Clique em Salvar token e formas.

Token e formas de pagamento

Passo 3: Cadastre a conta Asaas

Clique em Nova conta (ou Adicionar conta, se for a primeira) e preencha:

Campo

O que colocar

Nome da conta

Um nome só para você identificar no OMS (ex.: Conta matriz).

Tipo

Conta principal (a conta raiz da operação) ou Conta secundária (outras contas que você também quer gerenciar).

Ambiente

Homologação (sandbox) para testes ou Produção.

Token da API

A chave de API dessa conta. Ela fica criptografada e nunca mais é exibida por completo.

Clique em Salvar.

Nova conta Asaas

Passo 4: Abra a conta e teste a conexão

A conta aparece na lista. Clique em Recebedores para abri-la e depois em Testar conexão. A mensagem "Conexão com a Asaas confirmada" indica que o token está correto.

Conta salva Testar conexão

Passo 5 (opcional): Crie subcontas Asaas pelo painel

Pule este passo se os recebedores já tiverem conta Asaas própria. Nesse caso, você só vai precisar do wallet id de cada uma no Passo 6.

Para criar uma subconta sem sair da Shopify, clique em Novo recebedor e preencha:

  • Nome, E-mail e, se quiser, um E-mail de login diferente

  • CPF ou CNPJ e Celular

  • Tipo da empresa, obrigatório apenas para CNPJ (MEI, Limitada, Individual ou Associação)

  • Faturamento / renda mensal, que a Asaas exige para o cadastro regulatório

  • Endereço completo (CEP, número, bairro)

Clique em Criar na Asaas.

⚠️ Atenção:

  • A Asaas mostra a chave de API da subconta uma única vez. Copie e guarde em local seguro antes de clicar em Já copiei.

  • Só contas raiz com CNPJ podem criar subcontas. Contas PF não podem.

Novo recebedor

Passo 6: Vincule um recebedor a cada location

Clique em Locais. Cada location da loja aparece em uma linha. Para cada uma, escolha em Recebedor:

  • uma subconta criada no Passo 5, que aparece direto na lista; ou

  • Outro (informar wallet id), para usar qualquer conta Asaas, inclusive uma que não seja subconta da sua. Cole o wallet id dela no campo que aparece.

O OMS grava os metafields do split na location automaticamente. Você não precisa criar nenhum campo.

Locais Asaas

Passo 7: Defina os percentuais e salve

Na mesma linha, defina:

  • % frete: quanto do valor do frete vai para o recebedor da location.

  • % itens: quanto do valor dos produtos vai para o recebedor.

No exemplo, a location recebe 100% do frete e 90% dos itens. O restante fica na conta principal. Clique em Salvar na linha e aguarde a mensagem "Recebedor Asaas associado à location".

Percentuais Recebedor associado

Repita para cada location que deve participar do split. Locations com Sem recebedor não dividem o pagamento.

Passo 8: Importe e ative o fluxo no Shopify Flow

O split acontece quando o pedido é criado. Quem avisa o OMS é um fluxo do Shopify Flow:

  1. Abra Apps → Flow e clique em Importar.

  2. Selecione o arquivo Split.flow (anexo) e clique em Importar.

    Split.flow

    1.5 KB

Importar no Flow

  1. Abra o fluxo Split. Ele começa em Order created e envia o pedido para o OMS.

  2. Clique em Ativar fluxo de trabalho e confirme em Ativar.

Fluxo Split Ativar fluxo

✅ Pronto! A partir de agora, cada pedido pago via Asaas e atendido por uma location configurada tem o valor dividido automaticamente, conforme os percentuais definidos.


Perguntas frequentes

Preciso que o recebedor seja subconta da minha conta Asaas? Não. Qualquer conta Asaas pode receber o split. Use a opção Outro e informe o wallet id. As subcontas criadas pelo painel são só uma facilidade para quem ainda não tem conta.

Onde encontro o wallet id de uma conta Asaas? O titular da conta recebedora encontra o wallet id no painel da Asaas, na área de integrações. Ele também é retornado pela API da Asaas no campo walletId.

Posso testar antes de ir para produção? Sim. Cadastre uma conta com ambiente Homologação (sandbox) e uma chave $aact_hmlg_.... Quando estiver tudo certo, cadastre a conta de produção.

Uma location pode ter percentuais diferentes para frete e itens? Sim. Os dois campos são independentes. Você pode, por exemplo, repassar 100% do frete e 85% dos produtos.