Paylogos
  1. Compradores
Paylogos
  • GUIA DE IMPLEMENTAÇÃO
    • INTRODUÇÃO E ASPECTOS GERAIS
      • Introdução a Paylogos
      • Requisitos de segurança
      • Autenticação
      • Bandeiras aceitas
      • Conta Gráfica Paylogos
      • Webhook
        • Notificações e eventos
        • Webhook com autorização
    • CADASTRO E CREDENCIAMENTO
      • Compradores
    • GESTÂO DE TRANSAÇÃO E RECEBÍVEIS
      • Pagamentos digitais
      • Recebível
      • Pagamentos Recorrentes (Planos e Assinaturas)
      • Recibo
      • Eventos de webhook
      • Dúvidas frequentes (FAQ)
      • Cartão de crédito online
        • Cobrando com cartão de crédito online
        • Coletando dados de cartão
        • Autorização direta de transações
        • Cobrando com o id do customer (customer_id)
        • Cobrando com o id do cartão (card_id)
        • Pré-autorização de transações
        • Parcelando transações
        • Utilizando Data Only
        • Utilizando 3DS MPI
      • Boleto bancário
        • Cobrando com boleto bancário
        • Layout boleto
        • Gerando um boleto
        • Multa, juros e descontos
      • PIX
        • Cobrando com Pix online
        • Pix online
        • Preparando o seller para oferta do Pix online
        • Criando uma transação Pix online
        • Regras de Payout Pix online
      • Cancelamentos e Extornos
        • Cancelando transações cartão
        • Solicitação de cancelamento e estorno de boletos
        • Estorno da transação Pix
    • REPASSES E TRANSFERÊNCIAS
      • Transferência
      • Política de recebimento
      • Saldo de conta
      • Eventos de webhook
      • Dúvidas frequentes (FAQ)
  • REFERÊNCIAS DE API
    • INTRODUÇÃO E ASPECTOS GERAIS
      • Introdução
      • Requisitos de segurança
      • Autenticação
      • Testando
      • Códigos de erro
    • CADASTRO E CREDENCIAMENTO
      • Compradores
        • Criar comprador
          POST
        • Listar compradores
          GET
        • Alterar comprador
          PUT
        • Recuperar detalhes de comprador por ID
          GET
        • Remover comprador por ID
          DELETE
        • Buscar comprador por CPF/CNPJ
          GET
    • TOKENIZAÇÃO DE CARTÃO
      • Tokenização de cartão
        • Criar novo token de cartão
    • GESTÃO DE TRANSAÇÕES E RECEBÍVEIS
      • Gestão de cartão
        • Associar cartão com comprador
        • Listar detalhes de cartão pelo identificador
        • Remover cartão pelo identificador
      • Transações
        • Criar transação - Autorização Direta
        • Criar transação - Usando Customer ID
        • Criar transação - Usando Card ID
        • Criar transação - Boleto com PIX
        • Criar transação - Boleto Simples
        • Criar transação - Boleto Completo
        • Criar transação - PIX
        • Listar transações
        • Listar detalhes de transação pelo identificador
        • Alterar detalhes de transação pelo identificador
        • Estornar transação
        • Disponibilizar link carta de cancelamento
      • Source
        • Criar source para utilização transação
        • Listar detalhes de source pelo identificador
        • Remover source pelo identificador
      • Boleto
        • Enviar cobrança de boleto por email
        • Listar detalhes de boleto
        • Solicitar cancelamento de boleto
      • Planos de Recorrência
        • Criar um plano
        • Listar planos
        • Recupera um plano pelo identificador
        • Alterar plano pelo identificador
        • Deletar um plano pelo identificador
      • Assinatura de Recorrência
        • Criar uma assinatura
        • Listar assinaturas
        • Listar os detalhes de uma assinatura pelo identificador
        • Alterar os detalhes de uma assinatura pelo identificador
        • Remover uma assinatura pelo identificador
        • Suspender uma assinatura pelo identificador
        • Reativa uma assinatura pelo identificador
      • Fatura de Recorrência
        • Criar uma fatura avulsa
        • Listar faturas
        • Listar os detalhes de uma fatura pelo identificador
        • Remover uma fatura pelo identificador
        • Aprovar fatura pendente
        • Estornar e reembolsar fatura
      • Recibo
        • Enviar recibo por email
        • Enviar recibo por SMS
        • Recuperar detalhes do recibo
        • Renderizar template de recibo HTML
      • Recebível
        • Listar detalhes de recebível
        • Listar recebíveis por transação
    • REPASSES E TRANSFERÊNCIAS
      • Saldo de Conta
        • Listar contas por buyer
        • Listar histórico de lançamentos pelo identificador da conta
        • Listar histórico de lançamentos de conta
        • Listar histórico de lançamentos de conta por buyer
        • Recuperar saldo
      • Transferências
        • Listar transferências
        • Recuperar detalhes de transferência
        • Listar transações associadas a transferência
      • Lançamentos Futuros
        • Listar lançamentos futuros
      • Saldo atual de Conta
        • Recuperar saldo atual de conta
    • NOTIFICAÇÕES E EVENTOS
      • Webhook
        • Criar webhook
        • Listar webhooks
        • Recuperar detalhes de webhook
        • Remover webhook
  1. Compradores

Criar comprador

POST
https://api.paylogos.com.br/v1/buyers
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.paylogos.com.br/v1/buyers' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "first_name": "Nome",
    "last_name": "Sobrenome",
    "email": "email_do_comprador@email.com",
    "phone_number": " 123456789",
    "taxpayer_id": "99999999999",
    "birthdate": "0001-01-01",
    "address": {
        "line1": "Endereco",
        "line2": "999",
        "line3": "APT 999",
        "neighborhood": "Downtown",
        "city": "Cidade",
        "state": "UF",
        "postal_code": "99999999",
        "country_code": "BR"
    }
}'
Response Response Example
200 - Exemplo 1
{
    "id": "string",
    "status": "new",
    "resource": "string",
    "account_balance": 0,
    "current_balance": 0,
    "first_name": "string",
    "last_name": "string",
    "email": "string",
    "phone_number": "string",
    "taxpayer_id": "string",
    "birthdate": "string",
    "description": "string",
    "address": {
        "line1": "string",
        "line2": "string",
        "line3": "string",
        "neighborhood": "string",
        "city": "string",
        "state": "string",
        "postal_code": "string",
        "country_code": "string"
    },
    "delinquent": true,
    "default_debit": "string",
    "default_credit": "string",
    "metadata": {},
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
}

Requisição

Parâmetros Header
Accept
string 
opcional
Exemplo:
application/json
Content-Type
string 
opcional
Exemplo:
application/json
Parâmetros Bodyapplication/json
first_name
string 
requerido
Primeiro nome do comprador
Exemplo:
Nome
last_name
string 
requerido
Último nome do comprador
Exemplo:
Sobrenome
email
string 
opcional
Email do comprador
Exemplo:
email_do_comprador@email.com
phone_number
string 
opcional
Telefone do comprador
Exemplo:
123456789
taxpayer_id
string 
requerido
CPF/CNPJ do comprador
Exemplo:
99999999999
birthdate
string <date>
requerido
Data de nascimento do comprador. Formato YYYY-MM-DD
Exemplo:
0001-01-01
address
object (AddressRequest) 
requerido
line1
string 
opcional
Rua
Exemplo:
Endereco
line2
string 
opcional
Número
Exemplo:
999
line3
string 
opcional
Complemento
Exemplo:
APT 999
neighborhood
string 
opcional
Bairro/Distrito/Comunidade dentro de uma cidade
Exemplo:
Downtown
city
string 
opcional
Cidade
Exemplo:
Cidade
state
string 
opcional
Código ISO 3166-2 para o estado, com duas letras. Ex.: "MG","RJ","PR"
Exemplo:
UF
postal_code
string 
opcional
CEP com 8 digitos sem separador
Exemplo:
99999999
country_code
string 
opcional
ISO 3166-1 alpha-2 - códigos de país de duas letras. Valor padrão: "BR"
Exemplo:
BR
Examples

Respostas

🟢200Vendedor Criado
application/json
Body
id
string 
opcional
status
string 
opcional
Exemplo:
newexpiredaction_requiredpendingenabledactivedisableddeleted
resource
string 
opcional
account_balance
number 
opcional
current_balance
number 
opcional
first_name
string 
opcional
last_name
string 
opcional
email
string 
opcional
phone_number
string 
opcional
taxpayer_id
string 
opcional
birthdate
string 
opcional
description
string 
opcional
address
object (AddressReturn) 
opcional
line1
string 
opcional
line2
string 
opcional
line3
string 
opcional
neighborhood
string 
opcional
city
string 
opcional
state
string 
opcional
postal_code
string 
opcional
country_code
string 
opcional
delinquent
boolean 
opcional
default_debit
string 
opcional
cartão default para compras
default_credit
string 
opcional
conta bancaria default para depositios
metadata
object 
opcional
created_at
string <date-time>
opcional
updated_at
string <date-time>
opcional
🟠400Problemas na criação do vendedor
🟠403Proibido
Modificado em 2025-06-12 21:03:34
Página anterior
Códigos de erro
Próxima página
Listar compradores
Built with