# 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