---
title: "Configuração de split de pagamento"
method: PUT
path: "/accounts/{account_number}/split-settings"
tags: ["Split de pagamentos"]
---

# Configuração de split de pagamento

`PUT /accounts/{account_number}/split-settings`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/accounts/{account_number}/split-settings`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p> Adicione ou atualize uma configuração de split de pagamento para uma conta transitória específica.</p> 
  <span class="bkly-ref-small-beta-tag">beta</span> 
  <span class="bkly-ref-scope-tag">scope: transaction.split.setting.write</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Configuração de split de pagamento](/docs/configuracao-split-pagamentos)."
}
[/block]

## Path parameters

- `account_number` string, required: O número da conta transitória designada para receber o valor a ser dividido entre as contas recebedoras.

## Parameters

- `#/paths/~1legal-agreements~1file/get/parameters/0` (unresolved $ref)
- `#/paths/~1legal-agreements~1file/get/parameters/1` (unresolved $ref)

## Request body

- SplitPaymentRequest
  - `fallbackAccountNumber` string, required: Número da conta reserva (utilizada quando não é possível distribuir o pagamento entre as contas recebedoras). Exemplo: “1414124214”.
  - `recipients` object[], required: Lista de objetos que deverá conter informações sobre as contas recebedoras.
    - `accountNumber` string, required: Número da conta recebedora.
    - `amountType` 'PERCENTAGE' | 'FIXED', required: Tipo do valor a ser enviado à conta recebedora com base na configuração definida.
    - `amount` number, required: Valor a ser enviado à conta recebedora, expresso em termos percentuais ou fixos, como definido no campo <code>amountType</code>.

## Response `200`

A solicitação foi aceita e uma configuração foi criada ou atualizada com sucesso.

- SplitPaymentResponse
  - `companyKey` string: Chave que identifica o parceiro dentro do Bankly.
  - `createdAt` string, date-time: Data e hora em que a configuração foi cadastrada.
  - `updatedAt` string, date-time: Data e hora em que a configuração foi atualizada.
  - `originAccount` object: Objeto que contém informações sobre a conta transitória.
    - `branch` string: Número da agência da conta transitória.
    - `number` string: Número da conta transitória.
    - `bank` Bank
      - `ispb` string: ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco.
      - `code` string: Código do banco.
      - `name` string: Nome do banco.
  - `fallbackAccount` object: Objeto que contém informações sobre a conta reserva.
    - `branch` string: Número da agência da conta reserva.
    - `number` string: Número da conta reserva.
    - `bank` Bank
      - `ispb` string: ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco.
      - `code` string: Código do banco.
      - `name` string: Nome do banco.
  - `recipients` object[]: Lista de objetos que contém informações sobre as contas recebedoras.
    - `account` object: Objeto que contém informações sobre a conta recebedora.
      - `branch` string: Objeto que contém informações sobre a conta recebedora.
      - `number` string: Número da conta recebedora.
      - `bank` Bank
        - `ispb` string: ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco.
        - `code` string: Código do banco.
        - `name` string: Nome do banco.
    - `splitSetting` object: Objeto que contém informações sobre a configuração do valor ( percentual ou fixo) a ser enviado para a conta recebedora.
      - `amount` number: Valor a ser enviado à conta recebedora, expresso em termos percentuais ou fixos.
      - `amountType` 'PERCENTAGE' | 'FIXED': Tipo do valor a ser enviado à conta recebedora com base na configuração definida.

## Other responses

- `400` (unresolved $ref)
- `401` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/gest-o-de-contas.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-contas/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-contas/revisions/39000596dbd3?raw)