> For the complete documentation index, see [llms.txt](https://docs.barte.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.barte.com/api-reference/split-de-transacoes/split-pos-transacao.md).
# 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 pontual não disponível** - pode causar problemas se tentada
* O split não funciona para repasse no fluxo do tempo
* 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.barte.com/api-reference/split-de-transacoes/split-pos-transacao.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.