> ## Documentation Index
> Fetch the complete documentation index at: https://bmpdocs.moneyp.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Split de pagamento

**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**

```json theme={null}
"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**

```json theme={null}
"PropostaSplitPagamento": [
  {
    "VlrTransacao": 0,
    "DtPagamento": "2025-10-14T19:03:11.909Z",
    "LinhaDigitavel": "string",
    "DocumentoFederalCedente": "string",
    "NomeCedente": "string"
  }
]
```

***

## Regras de Negócio

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