---
title: "Criar Split de Pagamento"
method: POST
path: "/v2/seller/{idSeller}/charges/{chargeUuid}/split"
tags: ["Split de Pagamento"]
---

# Criar Split de Pagamento

`POST /v2/seller/{idSeller}/charges/{chargeUuid}/split`

## Request

- Base URL: `https://api.barte.com`
- URL: `https://api.barte.com/v2/seller/{idSeller}/charges/{chargeUuid}/split`
- Auth: API key in header `X-Token-Api`
- TypeScript: <https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/docs/v2/seller/:idSeller/charges/:chargeUuid/split/post.ts> (a function with typed inputs; its response is checked against the schema)

Divide o valor de uma charge entre múltiplos sellers (apenas após transação aprovada)

## Path parameters

- `idSeller` integer, required
- `chargeUuid` string, uuid, required

## Headers

- `x-token-api` string, required
- `Content-Type` 'application/json'

## Request body

- SplitRequest
  - `sellers` SplitSellerRequest[], required: Lista de sellers para divisão (máximo 10)
    - `idSeller` integer, required: ID do seller que receberá parte do valor
    - `value` number, double, required: Valor fixo ou porcentagem (dependendo do type)
    - `type` 'fixed' | 'percent', required: Tipo de divisão - valor fixo ou porcentagem

## Response `201`

Split criado com sucesso

- SplitResponse[]
  - `uuid` string, uuid
  - `status` 'SUCCESS' | 'PROCESSING' | 'ERROR'
  - `chargeValue` number, double
  - `split` SplitSellerResponse[]
    - `idSeller` integer
    - `splitValue` number, double
  - `timestamp` string, date-time

## Other responses

- `400`: Erro de validação ou dados inválidos
- `401`: Token inativo ou inexistente
- `403`: Acesso negado
- `404`: Charge não encontrada
- `409`: Conflito - charge já foi splitada ou valor excedido
- `429`: Muitas requisições
- `500`: Erro interno do servidor

---

[API](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada.md) - [All operations](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/llms.txt) - [OpenAPI document](https://skmtc.dev/barte/apis/api-de-sellers-v2-atualizada/revisions/f0dd55b167f1?raw)