COMECE AQUI

Split de Pagamento

Divida automaticamente pagamentos entre múltiplos recebedores. Ideal para marketplaces, plataformas de serviços e modelos de negócio que precisam distribuir valores entre parceiros.

Por que usar Split de Pagamento?

  • Automação total: Distribua valores automaticamente sem processos manuais
  • Flexibilidade: Configure percentuais ou valores fixos para cada recebedor
  • Transparência: Cada recebedor visualiza apenas suas transações
  • Compliance: Facilitador de pagamento registrado seguindo todas as normas

Como Funciona

1

Configure os recebedores

Cadastre os beneficiários do split com suas contas bancárias. Você pode ter recebedores fixos (marketplace) e recebedores dinâmicos (vendedores/prestadores).

2

Defina as regras de divisão

Configure percentuais ou valores fixos para cada recebedor. Defina quem paga as taxas de processamento e quando cada um recebe (na hora ou após confirmação).

3

Receba e divida automaticamente

Quando o pagamento for confirmado, o valor é automaticamente dividido e depositado nas contas de cada recebedor conforme as regras configuradas.

Casos de Uso

Marketplaces

Divida automaticamente o valor entre marketplace (comissão) e vendedores. Configure percentuais diferentes para cada categoria ou vendedor.

Plataformas de Serviços

Ideal para plataformas que conectam profissionais e clientes. Distribua o pagamento entre prestador e plataforma automaticamente.

Afiliados

Distribua comissões automaticamente para afiliados e produtores. Suporte a múltiplos níveis de comissionamento.

Eventos e Ingressos

Divida receitas de vendas de ingressos entre promotores, casas de show e plataforma de vendas automaticamente.

Exemplo de Integração

1. Criar cobrança Pix com split

POST https://api.validapay.com.br/pix?eventType=cob_pix
curl -X POST "https://api.validapay.com.br/pix?eventType=cob_pix" \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 2.5,
    "split": [
      {
        "master_account": "478152499",
        "valor_taxa": 0.10
      },
      {
        "master_account": "4353544787",
        "valor_taxa": 0.10
      }
    ],
    "webhook_url": "${SUA_URL}"
  }'

2. Resposta da API

Response 200 OK
{
  "status": "success",
  "data": {
    "txid": "abc123xyz789",
    "amount": 2.5,
    "qrcode": "00020126360014br.gov.bcb.pix...",
    "qrcode_image": "data:image/png;base64,iVBORw0KGg...",
    "split": [
      {
        "master_account": "478152499",
        "valor_taxa": 0.10,
        "valor_receber": 1.15
      },
      {
        "master_account": "4353544787",
        "valor_taxa": 0.10,
        "valor_receber": 1.15
      }
    ],
    "expiracao": "2024-01-20T15:30:00Z",
    "criado_em": "2024-01-20T14:30:00Z"
  }
}

Tipos de Divisão

Split por Percentual

Cada recebedor recebe uma porcentagem do valor total. Exemplo: 10% para o marketplace, 90% para o vendedor.

{ "tipo": "percentual", "valor": 10 }

Split por Valor Fixo

Cada recebedor recebe um valor fixo, independente do valor total. Exemplo: R$ 50,00 fixos para o marketplace.

{ "tipo": "fixo", "valor": 50.00 }

Split Misto

Combine valores fixos e percentuais. Exemplo: R$ 20,00 fixos + 5% do valor restante.

Configurado em múltiplas regras de split

Importante

  • • Validação de Saldo: A soma dos splits deve ser igual a 100% ou ao valor total da transação.
  • • Taxas: Defina claramente quem será responsável pelas taxas de processamento em cada split.
  • • KYC dos Recebedores: Todos os recebedores precisam ter cadastro completo e validado (KYC).
  • • Limites: Verifique os limites de transação para cada recebedor conforme o nível de validação.

Recursos Disponíveis

Múltiplas Contas Master

Divida pagamentos entre várias contas master (master_account) automaticamente

Definição de Taxas

Configure o valor da taxa (valor_taxa) para cada recebedor no split

Transferência Automática

Valores são transferidos automaticamente após confirmação do pagamento Pix

QR Code Gerado

Receba QR Code e código copia e cola para facilitar o pagamento

Cálculo Automático

O sistema calcula automaticamente o valor a receber após dedução das taxas

Webhooks em Tempo Real

Receba notificações sobre confirmação de pagamento e status das transferências

Endpoints Principais

POST/pix?eventType=cob_pix

Criar uma cobrança Pix com split entre múltiplas contas master

Próximos Passos