Criar Split

Criar Split de Pagamento

post

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

Autorizações

ApiKeyAuth

Parâmetros de rota

sellerIdintegerObrigatório

ID do seller dono da charge

Example: 123

chargeUuidstring · uuidObrigatório

UUID da charge a ser splitada

Example: 550e8400-e29b-41d4-a716-446655440000

Parâmetros de cabeçalho

x-token-apistringObrigatório

Token de autenticação para acesso à API

Content-Typestring · enumOpcional

Tipo de conteúdo da requisição

Valores possíveis:

Corpo

application/json

Respostas

201

Split criado com sucesso

application/json

400

Erro de validação ou dados inválidos

application/json

401

Token inativo ou inexistente

application/json

403

Acesso negado

application/json

404

Charge não encontrada

application/json

409

Conflito - charge já foi splitada ou valor excedido

application/json

429

Muitas requisições

application/json

500

Erro interno do servidor

application/json

post

HTTPcURLJavaScriptPython

POST /v2/sellers/{sellerId}/charges/{chargeUuid}/split HTTP/1.1
Host: api.barte.com
x-token-api: text
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "sellers": [
    {
      "idSeller": 456,
      "value": 50,
      "type": "fixed"
    },
    {
      "idSeller": 789,
      "value": 10,
      "type": "percent"
    }
  ]
}

[
  {
    "uuid": "ff3ae1e4-7e4d-47ae-a420-e65064c0c699",
    "status": "SUCCESS",
    "chargeValue": 4.94,
    "split": [
      {
        "sellerId": 5658,
        "splitValue": 0.01
      }
    ],
    "timestamp": "2025-09-03T17:44:06.103Z"
  }
]