# Criando um Comprador

Na Barte, todo pedido (**order**) precisa estar associado a um **comprador**.\
Por isso, antes de criar uma order, é necessário registrar o comprador e obter o seu **`uuid`** ou buscar por um comprador já cadastrado para associá-lo ao pedido.     

O **comprador** representa a pessoa física ou jurídica que realizará a transação.\
Ele armazena informações como:

* Nome e e-mail
* Documento (CPF/CNPJ)
* Dados de contato
* Endereço

### Criar um comprador (Buyer)

O comprador representa a pessoa que realizará o pagamento.

#### Endpoint

```
POST /v2/buyers
https://api.barte.com/v2/buyers
```

#### Headers

```
X-Token-Api: YOUR_API_KEY
Content-Type: application/json
Accept: */*
```

#### Body

```json
{
  "document": {
    "documentNumber": "48637879012",
    "documentType": "cpf",
    "documentNation": "BR"
  },
  "name": "John Doe",
  "email": "johndoe@barte.com",
  "countryCode": "+55",
  "phone": "34999991111",
  "alternativeEmail": "johndoealt@barte.com",
  "address": {
    "street": "Rua Orleans",
    "number": "100",
    "complement": "Bloco A",
    "district": "Jardim Europa",
    "city": "Uberlândia",
    "state": "Minas Gerais",
    "country": "BR",
    "zipCode": "38414552"
  }
}
```

#### Response

```json
{
  "uuid": "1ee849a4-6bb3-47f0-b32a-293a8f0e811c",
  "document": "48637879012",
  "name": "John Doe",
  "countryCode": "+55",
  "phone": "34999991111",
  "email": "johndoe@barte.com",
  "alternativeEmail": "johndoe@barte.com"
}
```

> ✅ Guarde o campo **uuid**, ele será utilizado na criação do pedido.

Veja a referencia API do endpoint de criação de buyers clicando no link abaixo para entender sobre todos os campos, retornos de sucesso e erro e demais informações:

{% content-ref url="<https://app.gitbook.com/s/hY03QzfTvLWOjOsYfPiz/compradores/criar-comprador>" %}
[Criar Comprador](https://app.gitbook.com/s/hY03QzfTvLWOjOsYfPiz/compradores/criar-comprador)
{% endcontent-ref %}