Criar Comprador

Cria um buyer

post

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

/v2/buyers

Cria um buyer e retorna o seu identificador (UUID) junto aos dados fornecidos

Authorizations

X-Token-Api

X-Token-ApistringRequired

Body

application/json

namestring · max: 255RequiredExample: Tester

emailstring · email · max: 150RequiredExample: [e-mail]

countryCodestring · max: 4OptionalExample: +55

phonestring · max: 11RequiredExample: 34999991111Pattern: ^\d{10,11}$

alternativeEmailstring · email · max: 150OptionalExample: [e-mail]

Responses

201

buyer cadastrado com sucesso.

application/json

uuidstringOptionalExample: 1ee849a4-6bb3-47f0-b32a-293a8f0e811c

documentstringOptionalExample: 36880261019

namestringOptionalExample: Tester

countryCodestringOptionalExample: +55

phonestringOptionalExample: 34999991111

emailstringOptionalExample: [e-mail]

alternativeEmailstringOptionalExample: [e-mail]

400

Requisição inválida

application/json

401

Não autorizado

application/json

403

Acesso proibido

application/json

500

Erro interno do servidor

application/json

post/v2/buyers

HTTPcURLJavaScriptPython

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

{
  "document": {
    "documentNumber": "36880261019",
    "documentType": "cpf",
    "documentNation": "BR"
  },
  "name": "Tester",
  "email": "[e-mail]",
  "countryCode": "+55",
  "phone": "34999991111",
  "alternativeEmail": "[e-mail]",
  "address": {
    "street": "Rua Orleans",
    "number": "100",
    "complement": "Bloco A",
    "district": "Jardim Europa",
    "city": "Uberlândia",
    "state": "Minas Gerais",
    "country": "BR",
    "zipCode": "38414552"
  }
}

{
  "uuid": "1ee849a4-6bb3-47f0-b32a-293a8f0e811c",
  "document": "36880261019",
  "name": "Tester",
  "countryCode": "+55",
  "phone": "34999991111",
  "email": "[e-mail]",
  "alternativeEmail": "[e-mail]"
}