Pular para o conteúdo principal

​
Split de Pagamento na Criação da Proposta

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 — Conta

Payload enviado ao BMP "PropostaLancamentos": [ { "CampoID": "string", "VlrTransacao": 0, "CodigoBanco": 0, "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" } ]

​
Split de Pagamento — Boleto

Payload enviado ao BMP "PropostaLancamentos": [ { "CampoID": "string", "VlrTransacao": 0, "DtPagamento": "2025-10-14T19:03:11.909Z", "LinhaDigitavel": "string", "DocumentoFederalCedente": "string", "NomeCedente": "string" } ]

​
Regras de Negócio

Nº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.