📌 O que é o Split de Pagamentos?

O Split de Pagamentos da Paytime é o recurso que permite dividir automaticamente o valor de uma transação entre dois ou mais recebedores.

Esse processo acontece de forma transparente e automatizada, garantindo que cada parte envolvida receba a sua parcela de forma correta e no prazo definido.

🎯 Objetivo do Split

O Split foi criado para atender modelos de negócio que precisam orquestrar recebíveis de forma eficiente, como:

• 🛒 Marketplaces: dividir o valor entre o vendedor e a plataforma.
• 🍔 Aplicativos de delivery: repassar valores entre restaurante, entregador e plataforma.
• 🏬 Franquias: distribuir recebíveis entre a franqueadora e as franquias.
• 🧾 SaaS e plataformas: dividir ganhos entre parceiros e provedores de serviço.

👥 Quem pode ser recebedor no Split?

Consulte a documentação das Regras do Split

⚙️ Como funciona Split da Transação na prática?

Na Paytime, o Split pode ser aplicado:

1. Split na Transação (em tempo real)

   1. O objeto split é enviado no payload da criação da transação.
   2. A transação primária é criada normalmente.
   3. O Split é processado em segundo plano, e o resultado é comunicado via webhook.
   4. Consulte a Documentação
      

2. Split Pós-Transação (manual )

   1. Aplicado em transações já criadas.
   2. Permite adicionar, desfazer ou refazer a divisão de valores.
   3. Ideal para ajustes operacionais ou quando as regras de divisão são conhecidas apenas após o fechamento.
   4. Consulte a Documentação
      

3. Split - Pré
   Os recebedores e as regras de divisão são pré-definidos.

   1. O split é executado automaticamente no momento da criação da transação.
   2. Permite configurar múltiplas regras, desde que não haja conflitos (ex.: duas regras para a mesma modalidade e canal não são permitidas).
   3. Pode ser usado em diferentes modalidades (crédito, débito, Pix) e canais (presencial ou online).
   4. Consulte a Documentação

🔔 Acompanhamento via Webhooks

Toda atualização relacionada ao Split é comunicada em tempo real via webhooks, garantindo visibilidade completa sobre o processamento.

Os eventos permitem acompanhar:

• Criação do split
• Sucesso ou falha da divisão
• Atualização da transação original após o split

📘 Consulte a documentação de Webhooks para mais detalhes.

📡 Sequência de eventos após um Split bem-sucedido

Quando um split é realizado com sucesso, múltiplos webhooks são disparados para refletir todas as alterações envolvidas no processo.

🔹 1. Transações derivadas

Para cada transação gerada a partir do split, é disparado o evento:

'new-sub-transaction'

👉 Representa a criação de uma nova sub-transação vinculada ao split.

🔹 2. Transação original

A transação que originou o split é atualizada, e um webhook é enviado:

'updated-sub-transaction'

👉 Indica que a transação original foi modificada para refletir a divisão realizada.

🔹 3. Registro do split

Ao final do processo, é disparado o evento consolidado:

'new-sub-split'

👉 Representa a criação do vínculo de split entre as transações.

📌 Observações importantes

• A quantidade de eventos new-sub-transaction varia conforme o número de divisões realizadas
• A ordem dos eventos segue o fluxo de processamento, podendo haver pequenas variações de tempo entre eles