# Split Pós-Transação
## **Visão Geral**
A API de Split permite dividir valores de transações pós-venda entre múltiplos sellers - ideal para maquininhas (POS) que precisam distribuir valores após a aprovação da transação.
### **💡 Guia de Implementação**
**Fluxo recomendado**
```flow
A [Venda] --> B [Transação Aprovada]
B --> C[Receber UUID da Charge]
C --> D[Aguardar Confirmação via webhook/consulta]
D --> E[Criar Split PÓS-transação]
E --> F[Monitorar Status]
F --> G{Status?}
G -->|PROCESSING| F
G -->|COMPLETED| H[✅ Split Programado]
G -->|ERROR| I[❌ Tratar Erro]
H --> J[Valores aparecerão no
statement na data de execução]
```
### ⚠️ Limitações Importantes
* **Split Pós-Transação**
* Só funciona **APÓS** transação aprovada e processada
* Não é possível fazer split no momento da compra
* Aguarde confirmação da transação antes de criar o split
* **Impacto Financeiro**
* Valores splitados **não aparecem** no statement/balance até execução
* **Antecipação não disponível** - pode causar problemas se tentada
* Cálculos financeiros devem considerar essa diferença
### **Validações automáticas**
Antes de criar um split, o sistema verifica:
* **Sellers existem** e estão ativos
* **Valores são válidos** (positivos, máx. 2 decimais)
* **Soma não excede** o valor da charge
* **Porcentagens** não passam de 100%
* **UUID válido** (formato v4)
* **Máximo 10 sellers** por split
### **❓ Troubleshooting**
#### **Problemas Comuns**
* UUID não encontrado
* Confirme se a transação foi **APROVADA na maquininha**
* Aguarde alguns segundos após aprovação antes do split
* Verifique se está usando o seller correto na URL
* Use o UUID completo (36 caracteres)
* Token inativo
* Verifique se o token está correto
* Confirme se é o token do seller principal
* Token pode ter expirado - gere um novo
* Valor total excedido
* Some todos os valores fixos e porcentagens
* Considere taxas já aplicadas na transação
* Verifique se a charge não foi parcialmente splitada
* Split ainda processando
* Normal levar alguns segundos
* Consulte o status periodicamente
* Se > 1 minuto, contate suporte
* Não vejo valores no balance
* **NORMAL** - valores só aparecem na data de execução
* Não tente antecipar - pode causar problemas
* Aguarde a data programada de liquidação
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.barte.com/api-reference/split-de-transacoes/split-pos-transacao.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.