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