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.

Cria um novo seller

post

Autorizações

Corpo

documentstringObrigatório

CPF ou CNPJ do seller (Exemplo "65800562000165")

companyNamestringObrigatório

Nome da empresa (Exemplo "Old Order")

fantasyNamestringObrigatório

Nome fantasia da empresa

sellerUrlstring · uriObrigatório

URL do site do seller

ipstring · ipv4Obrigatório

Endereço IP do vendedor (Exemplo "177.205.84.222")

webhookstring · uriObrigatório

URL do webhook para notificações (Exemplo "https://webhook-test.com/331f79e7e78dc080b8f4c5835e39ebfe")

emailstring · emailObrigatório

Email de contato (Exemplo "[e-mail]")

passwordstringObrigatório

Senha para acesso (Min. 8 e Max. 30) (Exemplo "cp202729")

Respostas

200

Seller criado com sucesso

application/json

207

Resposta de status misto (criação parcial ou erros)

application/json

400

Requisição inválida

application/json

401

Erro de autenticação ou autorização

application/json

501

Método inválido

application/json

post

HTTPcURLJavaScriptPython

POST /v2/seller HTTP/1.1
Host: sandbox-api.barte.com
X-Token-Api: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 708

{
  "document": "65800562000165",
  "companyName": "Old Order",
  "fantasyName": "Old Order Tecnologia",
  "sellerUrl": "oldorder.com.br",
  "ip": "177.205.84.222",
  "webhook": "https://webhook-test.com/331f79e7e78dc080b8f4c5835e39ebfe",
  "email": "[e-mail]",
  "password": "cp202729",
  "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": "[e-mail]",
    "countryCode": "+55",
    "phone": "31999887766"
  },
  "account": {
    "bank": "1",
    "issuer": "144111",
    "issuerDigit": "6",
    "number": "1425",
    "bankDigit": "5",
    "accountType": "CHECKING_ACCOUNT",
    "pixKey": "50307285030",
    "pixKeyType": "DOCUMENT"
  }
}

{
  "document": "65800562000165",
  "idSeller": 12345,
  "companyName": "Old Order",
  "email": "[e-mail]",
  "webhook": "https://webhook-test.com/331f79e7e78dc080b8f4c5835e39ebfe",
  "X-Api-Token": "ff8358b5-e6f3-4031-a16b-5c7072de5fae"
}