LogoLogo
Suporte
  • Bem-vindo!
  • Início Rápido
    • Sua primeira transação
  • Conceitos
    • Diferença entre Intermediador e Seller
  • Métodos de Pagamento na Barte
  • Diferença entre Orders x Charges
  • Intermediador de Pagamentos
    • Portal do Intermediador
    • Gerencie seus vendedores
      • Criar vendedor
      • Atualizar dados bancários
      • Atualizar taxas
      • Consultar taxas
      • Consultar extrato
  • Vendedores
    • Portal do Vendedor
  • Financeiro
    • Solicitar Repasse
    • Recuperar Saldo
  • Relatórios
    • Extrato
  • Cobrança e Pagamentos
    • Como realizar uma cobrança?
      • Compradores
        • Criar buyer
        • Listar buyers
        • Buscar buyer
        • Atualizar buyer
      • Pagamentos pontuais
        • Criar Pagamento
          • Cartão Tokenizado (One Buy Click)
            • Criar Token
            • Criar Pagamento com Card Token
          • Pagamento de Cartão sem Tokenização
          • Pré-Captura
            • Capturar cobrança
            • Cancelar pré-captura
          • Pix
          • Boleto
        • Listar Pagamentos
        • Buscar Pagamentos
        • Cancelar Pagamentos
        • Atualizar Pagamentos
      • Cobranças
        • Consultar cobrança
        • Listar cobranças
        • Cancelar cobrança
      • Recorrências
        • Planos de Assinatura
          • Criar Plano de Assinatura
          • Listar planos
          • Buscar plano
          • Atualizar plano
        • Assinaturas
          • Criar assinatura
          • Cancelar assinatura
          • Atualizar assinatura
          • Listar assinaturas
          • Buscar assinatura
      • Link de pagamento
        • Criar link de pagamento
        • Atualizar link de pagamento
        • Apagar link de pagamento
        • Listar links de pagamento
        • Buscar link de pagamento
        • Simular valor a pagar e a receber no link
    • Como estornar uma transação?
      • Estorno Total
      • Estorno parcial
        • Estornar parcialmente charge
        • Consultar valor restante a ser estornado
    • Webhooks
  • Recursos
    • Principais dúvidas
    • Changelog
    • Status page
Fornecido por GitBook
LogoLogo
Nesta página

Isto foi útil?

  1. Cobrança e Pagamentos
  2. Como realizar uma cobrança?
  3. Compradores

Criar buyer

AnteriorCompradoresPróximoListar buyers

Atualizado há 6 dias

Isto foi útil?

Cria um buyers

post

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

Autorizações
Corpo
namestring · máx: 255ObrigatórioExample: Tester
emailstring · email · máx: 150ObrigatórioExample: comprador@email.com
countryCodestring · máx: 4OpcionalExample: +55
phonestring · máx: 11ObrigatórioExample: 34999991111Pattern: ^\d{10,11}$
alternativeEmailstring · email · máx: 150OpcionalExample: compradoralt@email.com
Respostas
201
buyer cadastrado com sucesso.
application/json
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
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": "comprador@email.com",
  "countryCode": "+55",
  "phone": "34999991111",
  "alternativeEmail": "compradoralt@email.com",
  "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": "05212972140",
  "name": "Erick Augusto",
  "countryCode": "+55",
  "phone": "34999991111",
  "email": "comprador@email.com",
  "alternativeEmail": "compradoralt@email.com"
}