> ## 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.

# Atualizar instrução

> Altere a regra (amount/type) de uma instrução já cadastrada.

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

Atualiza a regra de uma instrução já cadastrada em uma configuração de Split de Pagamento. Os dados do beneficiário (`transferType` e `beneficiary`) não são alterados por este endpoint.

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

<ParamField path="splitPaymentBeneficiaryId" type="string" required>
  ID da instrução que terá a regra atualizada.
</ParamField>

## Body

<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="amount" type="number" required>
  Valor a ser aplicado, conforme o `type` selecionado.
</ParamField>

## Response

<ResponseField name="id" type="number">Identificador único da configuração de split.</ResponseField>
<ResponseField name="createdAt" type="string">Data/hora de criação em ISO 8601.</ResponseField>
<ResponseField name="updatedAt" type="string">Data/hora da última atualização em ISO 8601.</ResponseField>
<ResponseField name="instructions" type="array">Lista atualizada de instruções da configuração, com a regra alterada.</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request PATCH 'https://apisandbox.delbank.com.br/baas/api/v1/split-payments/configurations/15/beneficiaries/18' \
  --header 'Content-Type: application/json' \
  --header 'x-delbank-api-key: {{apiKey}}' \
  --header 'x-delfinance-account-id: {{accountId}}' \
  --data '{
      "type": "PERCENTAGE",
      "amount": 3
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": 15,
    "bankAccountNumber": "CONTA_PAGADORA",
    "createdAt": "2025-09-19T20:04:38.112Z",
    "updatedAt": "2025-09-19T20:15:00.000Z",
    "instructions": [
      {
        "id": 18,
        "splitPaymentConfigurationId": 15,
        "amount": 3,
        "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"
          }
        }
      }
    ]
  }
  ```
</ResponseExample>