Criar Vendedor

Para iniciar o processo de integração, siga os passos abaixo para cadastrar um novo vendedor com sucesso.

Importante

Após criar um novo vendedor, salve o X-Token-Api retornado na resposta: ele é a credencial que autentica e autoriza todas as transações dessa conta.

Criar seller

post

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

/v2/seller

Cria um novo seller no sistema com novos campos obrigatórios

Authorizations

ApiKeyAuth

X-Token-ApistringRequired

Header parameters

X-Token-Apistring · uuidRequired

Token de autenticação UUID v4

Content-Typestring · enumRequired

Tipo de conteúdo da requisição

Possible values:

Body

application/json

documentstringRequired

CPF ou CNPJ do seller

Example: 12345678901

companyNamestringRequired

Nome da empresa

Example: Empresa Teste

fantasyNamestringRequired

Nome fantasia da empresa

Example: Fantasia Teste

sellerUrlstring · uriRequired

URL do site do seller

Example: empresa-teste.com.br

ipstring · ipv4Optional

Endereço IP do vendedor

Example: 177.205.84.222

webhookstring · uriRequired

URL do webhook para notificações

Example: https://webhook-test.com/331f79e7e78dc080b8f4c5835e39ebfe

emailstring · emailRequired

Email de contato

Example: [email protected]

passwordstringRequired

Senha para acesso

Example: senha123

mccCpfstring · enumOptional

Código MCC obrigatório quando document for CPF

Example: BUSINESS_SERVICESPossible values:

Responses

200

Seller criado com sucesso

application/json

400

Erro de validação

application/json

401

Token inativo ou inexistente

application/json

403

Acesso negado

application/json

500

Erro interno do servidor

application/json

post

/v2/seller

HTTPcURLJavaScriptPython

POST /v2/seller HTTP/1.1
Host: api.barte.com
X-Token-Api: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 779

{
  "document": "65800562000165",
  "companyName": "Old Order",
  "fantasyName": "Old Order Tecnologia",
  "webhook": "https://oldorder.com.br",
  "sellerUrl": "https://oldorder.com.br",
  "email": "[email protected]",
  "password": "cp202729",
  "owner": {
    "name": "João da Silva",
    "document": "51102616010",
    "birthdate": "1990-01-01"
  },
  "address": {
    "country": "BR",
    "state": "MG",
    "city": "Belo Horizonte",
    "district": "Centro",
    "street": "Avenida Afonso Pena",
    "zipCode": "30130001",
    "number": "1500",
    "complement": "Sala 202"
  },
  "contact": {
    "name": "João Silva",
    "email": "[email protected]",
    "countryCode": "55",
    "phone": "31999887766"
  },
  "account": {
    "account": {
      "bank": "001",
      "issuer": "144111",
      "issuerDigit": "6",
      "number": "1425",
      "bankDigit": "5",
      "accountType": "CHECKING_ACCOUNT"
    },
    "transferType": "PIX",
    "pix": {
      "keyType": "CNPJ",
      "key": "65800562000165"
    }
  }
}

{
  "document": "87654321000198",
  "idSeller": 28451,
  "companyName": "TECHNOLOGY SOLUTIONS BRASIL LTDA",
  "email": "[email protected]",
  "webhook": "https://api.technologysolutions.com.br/webhook",
  "x-token-api": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}