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 Vendedor

post

Cadastra um novo vendedor no Intermediador de Pagamentos.

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

Authorizations

ApiKeyAuth

X-Token-ApistringRequired

Chave de API do intermediador

Body

application/json

documentstringRequired

CPF ou CNPJ do vendedor

Example: 65800562000165

companyNamestringRequired

Razão social

Example: Old Order

fantasyNamestringRequired

Nome fantasia

Example: Old Order Tecnologia

webhookstring · uriRequired

URL para notificações via webhook

Example: https://oldorder.com.br

versionstring · enumOptional

Versão do formato de entrega do webhook. Quando omitido ou null, mantém o comportamento padrão da conta. Valores aceitos: "1.0" (legado) ou "2.0" (novo padrão).

Example: 2.0Possible values:

sellerUrlstring · uriRequired

URL do site do vendedor

Example: https://oldorder.com.br

emailstring · emailRequired

E-mail de acesso da conta

Example: [e-mail]

passwordstringRequired

Senha de acesso da conta

Example: cp202729

idPlanSellerintegerOptional

Identificador do plano de taxas que será aplicado a este vendedor. Obrigatório quando a conta do intermediador está configurada com taxas v2. Caso contrário, o campo é opcional.

Example: 123

ipstring · ipv4Optional

Endereço IP do vendedor (opcional)

Example: 200.100.50.25

mccCpfstringOptional

Merchant Category Code. Obrigatório quando o document é um CPF

Example: veterinary_services

Responses

200

Vendedor criado com sucesso

application/json

or

400

Erro de validação

application/json

401

Token inexistente ou inativo

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: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 814

{
  "document": "65800562000165",
  "companyName": "Old Order",
  "fantasyName": "Old Order Tecnologia",
  "webhook": "https://oldorder.com.br",
  "version": "2.0",
  "sellerUrl": "https://oldorder.com.br",
  "email": "[e-mail]",
  "password": "cp202729",
  "idPlanSeller": 123,
  "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": "[e-mail]",
    "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": "65800562000165",
  "idSeller": 12345,
  "companyName": "Old Order",
  "email": "[e-mail]",
  "x-token-api": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
  "webhooks": [
    {
      "uuid": "9c1f4b2e-3d7a-4f8c-b1e2-6a5d0c9e3f11",
      "title": "Webhook principal",
      "domains": [
        "CHARGES",
        "ORDERS"
      ],
      "active": true,
      "url": "https://oldorder.com.br"
    }
  ]
}