Pular para o conteúdo principal
Tipo: Síncrona Esta funcionalidade permite a configuração de Split de Pagamento no momento da criação da proposta, possibilitando o direcionamento de parte do valor da operação para contas bancárias ou boletos, antes do repasse do valor residual.

Recepção do Payload com Split de Pagamento

O endpoint de criação de proposta deve aceitar o objeto PropostaSplitPagamento, contendo os dados necessários para definição dos splits financeiros da operação.

Validações Obrigatórias

Antes do processamento do Split de Pagamento, o sistema deve realizar as seguintes validações:
  • Verificar se o corban está habilitado para utilização da funcionalidade de Split de Pagamento;
  • Validar se a soma dos valores dos splits informados não excede o valor solicitado da operação.

Persistência e Integração

Quando todas as validações forem atendidas:
  • As informações de Split devem ser persistidas e vinculadas à proposta;
  • Os dados devem ser enviados ao BMP Digital por meio do objeto PropostaLancamentos.

Tratamento de Erros

As seguintes situações devem resultar em rejeição da proposta:
  • Corban não habilitado para Split de Pagamento
    Mensagem retornada:
    Corban não autorizado para uso de Split de Pagamento.
  • Valor total dos Splits superior ao valor disponível da operação
    Mensagem retornada:
    Valor de Split superior ao valor disponível.

Estrutura de Payloads

Split de Pagamento — Conta

Payload recebido na criação da proposta
"PropostaSplitPagamento": [
  {
    "NumeroBanco": "string",
    "TipoConta": 0,
    "Agencia": "string",
    "AgenciaDig": "string",
    "Conta": "string",
    "ContaDig": "string",
    "DocumentoFederal": "string",
    "NomePagamento": "string"
  }
]

Split de Pagamento — Boleto

Payload recebido na criação da proposta
"PropostaSplitPagamento": [
  {
    "VlrTransacao": 0,
    "DtPagamento": "2025-10-14T19:03:11.909Z",
    "LinhaDigitavel": "string",
    "DocumentoFederalCedente": "string",
    "NomeCedente": "string"
  }
]

Regras de Negócio

RegraDescrição
1Autorização de Split (Conta)O corban deve possuir a funcionalidade habilitada para uso de Split do tipo Conta.
2Autorização de Split (Boleto)O corban deve possuir a funcionalidade habilitada para uso de Split do tipo Boleto.
3Validação de LimiteA soma dos valores dos Splits não pode ultrapassar o valor solicitado da operação.
4PersistênciaDados válidos devem ser persistidos e enviados ao BMP Digital.
5AuditoriaToda tentativa de envio ou rejeição deve ser registrada com data, hora e usuário responsável.
6Efeito ImediatoAs parametrizações de Split aplicam-se imediatamente às novas propostas criadas.