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

# Adicionar instrução

> Adicione uma nova instrução de repasse a uma configuração de Split de Pagamento existente.

<Note>
  Para o passo a passo completo, incluindo exemplos por tipo de repasse, veja o guia [Configurar Split de Pagamentos](/guias/split-pagamentos/configurar).
</Note>

Adiciona uma nova instrução de repasse a uma configuração de Split de Pagamento já existente, sem afetar as instruções já cadastradas. O formato do corpo é o mesmo de um item de `instructions` no endpoint de criação, e varia conforme o `transferType` escolhido.

## Headers

<ParamField header="x-delbank-api-key" type="string" required>
  Sua API key.
</ParamField>

<ParamField header="x-delfinance-account-id" type="string" required>
  Número da conta Delfinance.
</ParamField>

## Path

<ParamField path="splitPaymentId" type="string" required>
  ID da configuração de Split de Pagamento.
</ParamField>

## Body

<ParamField body="amount" type="number" required>
  Valor a ser aplicado, conforme o `type` selecionado.
</ParamField>

<ParamField body="type" type="string" required>
  Como o `amount` é calculado. Valores aceitos:

  * `PERCENTAGE`: o valor é calculado como uma porcentagem do valor total da transação. O percentual máximo permitido é **5%**.
  * `FIXED`: o valor é absoluto e fixo. Se o valor definido exceder **50%** do valor da transação, o split não é realizado.
</ParamField>

<ParamField body="transferType" type="string" required>
  Meio pelo qual o beneficiário recebe o valor. Valores aceitos: `INTERNAL`, `PIX_MANUAL`, `EXTERNAL`, `PIX_KEY`. Hoje, use apenas `INTERNAL` e `PIX_MANUAL` em produção. Veja detalhes em [Configurar Split de Pagamentos](/guias/split-pagamentos/configurar).
</ParamField>

<ParamField body="beneficiary" type="object" required>
  Dados da conta de destino. Os campos exigidos variam conforme o `transferType` (veja o guia de configuração).

  <Expandable title="propriedades">
    <ParamField body="number" type="string" required>
      Número da conta de destino.
    </ParamField>

    <ParamField body="branch" type="string">
      Agência da conta de destino.
    </ParamField>

    <ParamField body="participantIspb" type="string">
      ISPB da instituição de destino.
    </ParamField>

    <ParamField body="type" type="string">
      Tipo da conta de destino: `PAYMENT`, `CURRENT`, `SAVING`, `SALARY`, `ESCROW`, `MINIPI`, `ADMINISTERED`, `TRANSACTIONAL` ou `OWNER`.
    </ParamField>

    <ParamField body="holder" type="object">
      Dados do titular da conta de destino.

      <Expandable title="propriedades">
        <ParamField body="document" type="string">CPF ou CNPJ do titular.</ParamField>
        <ParamField body="name" type="string">Nome do titular.</ParamField>
        <ParamField body="email" type="string">E-mail do titular. Opcional.</ParamField>
        <ParamField body="phoneNumber" type="string">Telefone do titular. Opcional.</ParamField>
        <ParamField body="type" type="string">Tipo do titular: `NATURAL` ou `LEGAL`. Opcional.</ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

## Response

Retorna a configuração completa e atualizada, com a mesma estrutura descrita em [Criar configuração de Split](/api-reference/split-pagamentos/criar-split), incluindo a nova instrução na lista de `instructions`.

<RequestExample>
  ```bash cURL theme={null}
  curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/configurations/15/beneficiaries' \
  --header 'Content-Type: application/json' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}' \
  --data '{
      "amount": 50,
      "type": "FIXED",
      "transferType": "PIX_MANUAL",
      "beneficiary": {
          "number": "789012",
          "branch": "0001",
          "participantIspb": "12345678",
          "type": "CURRENT",
          "holder": {
              "document": "12345678901",
              "name": "Nome do beneficiário"
          }
      }
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": 15,
    "bankAccountNumber": "CONTA_PAGADORA",
    "createdAt": "2025-09-19T20:04:38.112Z",
    "updatedAt": "2025-09-19T20:10:00.000Z",
    "instructions": [
      {
        "id": 18,
        "splitPaymentConfigurationId": 15,
        "amount": 10,
        "type": "PERCENTAGE",
        "transferType": "INTERNAL",
        "beneficiary": {
          "number": "654321",
          "branch": "0001",
          "participantIspb": "12345678",
          "type": "PAYMENT",
          "holder": {
            "document": "12345678901",
            "name": "Nome do Beneficiário",
            "email": null,
            "phoneNumber": null,
            "type": "NATURAL"
          }
        }
      },
      {
        "id": 19,
        "splitPaymentConfigurationId": 15,
        "amount": 50,
        "type": "FIXED",
        "transferType": "PIX_MANUAL",
        "beneficiary": {
          "number": "789012",
          "branch": "0001",
          "participantIspb": "12345678",
          "type": "CURRENT",
          "holder": {
            "document": "12345678901",
            "name": "Nome do beneficiário",
            "email": null,
            "phoneNumber": null,
            "type": null
          }
        }
      }
    ]
  }
  ```
</ResponseExample>