Splits de Pagamento

Distribua valores automaticamente entre múltiplas contas em cada transação.
Resumo Rápido

O sistema de splits permite dividir automaticamente o valor de cada transação entre múltiplas contas. Ideal para marketplaces, revendas e parcerias.

1. Como Funciona

Ao criar um depósito ou pagamento, você pode especificar um array de splits que define como o valor será distribuído:

Pagamento

R$ 1.000,00

Valor total
Distribuição Automática:
Conta A (Vendedor) R$ 850,00 (85%)
Conta B (Plataforma) R$ 100,00 (10%)
Taxa de Serviço R$ 50,00 (5%)

2. Configurando Splits

Adicione o parâmetro split ao criar depósitos ou pagamentos:

Exemplo de Split 
{
  "type": "pix_qrcode",
  "amount": "1000.00",
  "split": [
    {
      "account_id": "uuid-conta-vendedor",
      "percentage": 85,
      "description": "Vendedor"
    },
    {
      "account_id": "uuid-conta-plataforma",
      "percentage": 10,
      "description": "Plataforma"
    },
    {
      "account_id": "uuid-conta-taxa",
      "percentage": 5,
      "description": "Taxa de serviço"
    }
  ]
}

Parâmetros do Split

Parâmetro Tipo Obrigatório Descrição
account_id string (UUID) Sim ID da conta que receberá a parte
percentage float Sim Percentual do valor (0-100)
description string Não Descrição da parte

3. Tipos de Split

Split Percentual

Distribui o valor em percentuais. Ideal para comissões e taxas variáveis. 

"percentage": 85
Split Fixo

Distribui valores fixos em BRL. Ideal para taxas fixas de serviço. 

"amount": "50.00"

4. Validação de Splits

Antes de criar um depósito com splits, valide se as contas estão configuradas corretamente:

Endpoint de Validação 
POST /api/v1/crypto/validate-splits
Request Body 
{
  "splits": [
    {
      "account_id": "uuid-conta-1",
      "percentage": 85
    },
    {
      "account_id": "uuid-conta-2",
      "percentage": 15
    }
  ],
  "amount": "1000.00"
}

5. Webhooks de Split

Receba notificações quando splits forem processados:

Evento Descrição
split.processed Split distribuído com sucesso
split.failed Falha ao distribuir split
split.refunded Split estornado

6. Exemplo Completo

Criando Depósito com Split 
curl -X POST "https://ajnapay.com.br/api/v1/deposits" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "pix_qrcode",
    "amount": "500.00",
    "description": "Venda de produto",
    "split": [
      {
        "account_id": "uuid-vendedor",
        "percentage": 90,
        "description": "Vendedor"
      },
      {
        "account_id": "uuid-plataforma",
        "percentage": 10,
        "description": "Comissão plataforma"
      }
    ]
  }'
Anterior: Crypto Próximo: Troubleshooting