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 ou documento internacional)

• 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

{
  "document": {
    "documentNumber": "48637879012",
    "documentType": "cpf",
    "documentNation": "BR"
  },
  "name": "John Doe",
  "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"
  }
}

Comprador com documento internacional: informe em documentNation o país emissor (ISO 3166-1 alfa-2) e em documentType o tipo do documento daquele país. Ex.: SSN dos Estados Unidos:

"document": {
  "documentNumber": "536904399",
  "documentType": "ssn",
  "documentNation": "US"
}

Veja todas as combinações aceitas em Documentos Aceitos. Passaporte não é aceito.

Response

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

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:

Criar Comprador