Criar Split

Criar Split de Pagamento

post

https://api.barte.comhttps://sandbox-api.barte.com

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

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

Authorizations

ApiKeyAuth

x-token-apistringRequired

Token de autenticação para acesso à API

Path parameters

idSellerintegerRequired

ID do seller dono da charge

Example: 123

chargeUuidstring · uuidRequired

UUID da charge a ser splitada

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

Header parameters

x-token-apistringRequired

Token de autenticação para acesso à API

Content-Typestring · enumOptional

Tipo de conteúdo da requisição

Possible values:

Body

application/json

Responses

201

Split criado com sucesso

application/json

uuidstring · uuidOptionalExample: ff3ae1e4-7e4d-47ae-a420-e65064c0c699

statusstring · enumOptionalExample: SUCCESSPossible values:

chargeValuenumber · doubleOptionalExample: 4.94

timestampstring · date-timeOptionalExample: 2025-09-03T17:44:06.103Z

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

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

HTTPcURLJavaScriptPython

POST /v2/seller/{idSeller}/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": [
      {
        "idSeller": 5658,
        "splitValue": 0.01
      }
    ],
    "timestamp": "2025-09-03T17:44:06.103Z"
  }
]