Sobre o Split de Pagamentos

O Split de Pagamentos é uma funcionalidade que permite dividir o valor solicitado em uma proposta de crédito entre múltiplos destinatários, seja por transferência bancária (conta) ou por pagamento de boletos.

No caso do E-Consignado Trabalhador, o split de pagamentos está disponível apenas na modalidade de Contratação Ativa.

​

Como Funciona

Na BMP, a configuração de split segue o seguinte fluxo:

1. Autorização do Corban: o parceiro correspondente (corban) precisa estar habilitado para usar o Split, seja por conta ou por boleto;
2. Criação da Proposta com Split: ao criar uma proposta, o sistema recebe um objeto chamado PropostaSplitPagamento, que contém os dados dos destinatários e valores a serem repassados;
3. Validação Automática: o sistema verifica:
   • Se o parceiro contatou o serviço de split;
   • Se a soma dos valores de split não excede o valor total solicitado;
4. Persistência e Envio ao BMP Digital: se tudo estiver válido, os dados são:
   • Persistidos junto à proposta;
   • Enviados ao BMP Digital no objeto PropostaLancamentos, garantindo rastreabilidade;
5. Auditoria e Retorno: toda ação (envio ou rejeição) é registrada com data, hora e usuário. O sistema retorna a confirmação da proposta e dos splits registrados.

​

Como Fazer

Verifique se o corban está habilitado: antes de usar o Split, confirme se o corban está autorizado para:

• Split por Conta;
• Split por Boleto.

Procure o suporte da BMP para realizar a inclusão desse serviço no seu cadastro de parceiro.

​

Exemplo de Requisição

Para realizar propostas com split de pagamento, utilize o endpoint /contrato/oferta-ativa/gerar-contrato.

Os dados do split devem ser inseridos dentro do objeto propostaLancamentos, conforme o exemplo abaixo:

curl -X 'POST' \
  'https://econsignadotrabalhador.moneyp.dev.br/contrato/oferta-ativa/gerar-contrato' \
  -H 'accept: text/plain' \
  -H 'IdempotencyKey: ss' \
  -H 'Content-Type: application/json' \
  -d '{
  "dto": {
    "documentoCliente": "string",
    "documentoPromotor": "string",
    "documentoParceiroCorrespondente": "string",
    "observacoesVendedor": "string",
    "codigoOperacao": "string",
    "codigoVersaoCCB": 0,
    "tipoIndiceFinan": 0,
    "percIndiceFinan": 10000000000000,
    "vlrSolicitado": 10000000000000000,
    "prazo": 0,
    "percJurosNegociado": 10000000000000,
    "vlrIOF": 10000000000000000,
    "percIOF": 10000000000000,
    "percIOFAdicional": 10000000000000,
    "vlrParcela": 10000000000000000,
    "vlrTAC": 10000000000000000,
    "vlrBoleto": 10000000000000000,
    "dtPrimeiroVencto": "2025-10-14T19:14:55.907Z",
    "vlrOutrasDespesas": 10000000000000000,
    "vlrOutrosServicos": 10000000000000000,
    "vlrSeguro": 10000000000000000,
    "vlrCorban": 10000000000000000,
    "vlrAvaliacao": 10000000000000000,
    "vlrDespachante": 10000000000000000,
    "vlrRegistro": 10000000000000000,
    "vlrServTerceiro": 10000000000000000,
    "vlrRegistroCartorio": 10000000000000000,
    "vlrTxAdmMensal": 10000000000000000,
    "vlrSeguroMensal1": 10000000000000000,
    "vlrSeguroMensal2": 10000000000000000,
    "hotMoney": true,
    "nroDiasAcrescimoHotMoney": 0,
    "rotativo": true,
    "tipoContrato": "strin",
    "percRetencao": 10000000000000,
    "vlrRetencao": 10000000000000000,
    "vlrBlindagem": 10000000000000000,
    "vlrAcessorios": 10000000000000000,
    "vlrVistoria": 10000000000000000,
    "numeroApolice": "string",
    "vlrCertiDocs": 10000000000000000,
    "numeroCCB": 0,
    "propostaContaPagamentoDTO": {
      "codigoBanco": 0,
      "tipoConta": 0,
      "agencia": "stri",
      "agenciaDig": "s",
      "conta": "string",
      "contaDig": "s",
      "numeroBanco": "string",
      "documentoFederalPagamento": "string",
      "nomePagamento": "string"
    },
    "propostaLancamentos": [
      {
        "campoID": "string",
        "vlrTransacao": 0,
        "dtPagamento": "2025-10-14T19:14:55.907Z",
        "linhaDigitavel": "string",
        "codigoBanco": 0,
        "numeroBanco": "string",
        "tipoConta": 0,
        "agencia": "stri",
        "agenciaDig": "s",
        "conta": "string",
        "contaDig": "s",
        "documentoFederal": "string",
        "nomePagamento": "string",
        "documentoFederalCedente": "string",
        "nomeCedente": "string"
      }
    ]
  },
  "parametros": [
    {
      "nome": "string",
      "valor": "string"
    }
  ]
}'

​

Retornos e Logs

Se a proposta for aceita, o parceiro recebe uma confirmação e os splits serão registrados.

Possíveis erros:

• Corban não autorizado para uso de Split de Pagamento.;
• Valor de Split superior ao valor disponível..