Split Pós-transação

Divida valores de transações entre múltiplos vendedores automaticamente

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

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<br/>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