Criar Cliente

curl --request POST \
  --url https://zeus-sandbox.autorizou.dev/api/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "email": "<string>",
  "documents": [
    {
      "documents[].type": "<string>",
      "documents[].value": "<string>"
    }
  ],
  "addresses": [
    {
      "addresses[].type": "<string>",
      "addresses[].postal_code": "<string>",
      "addresses[].line_1": "<string>",
      "addresses[].line_2": "<string>",
      "addresses[].number": "<string>",
      "addresses[].neighborhood": "<string>",
      "addresses[].city": "<string>",
      "addresses[].state": "<string>",
      "addresses[].country": "<string>"
    }
  ],
  "phone": {
    "phone.type": "<string>",
    "phone.ddi": "<string>",
    "phone.ddd": "<string>",
    "phone.number": "<string>"
  }
}
'

POST

api

customers

Criar Cliente

curl --request POST \
  --url https://zeus-sandbox.autorizou.dev/api/v1/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "email": "<string>",
  "documents": [
    {
      "documents[].type": "<string>",
      "documents[].value": "<string>"
    }
  ],
  "addresses": [
    {
      "addresses[].type": "<string>",
      "addresses[].postal_code": "<string>",
      "addresses[].line_1": "<string>",
      "addresses[].line_2": "<string>",
      "addresses[].number": "<string>",
      "addresses[].neighborhood": "<string>",
      "addresses[].city": "<string>",
      "addresses[].state": "<string>",
      "addresses[].country": "<string>"
    }
  ],
  "phone": {
    "phone.type": "<string>",
    "phone.ddi": "<string>",
    "phone.ddd": "<string>",
    "phone.number": "<string>"
  }
}
'

Este endpoint permite cadastrar um novo cliente na plataforma Autorizou. O cliente é uma entidade obrigatória para processar qualquer pagamento e pode ter múltiplos cartões associados.

Casos de Uso

📝 Cadastro inicial de novos compradores
🔄 Onboarding de usuários em marketplaces
📊 Gestão de relacionamento com compradores
💳 Preparação para futuras transações

Parâmetros Obrigatórios

name

string

required

Nome completo do cliente (máximo 191 caracteres)

string

required

Email válido e único por merchant (máximo 191 caracteres)

Parâmetros Opcionais

Documentos

documents

array

Lista de documentos do cliente (CPF, CNPJ, RG, Passaporte ou Outro)

Show Propriedades

documents[].type

string

required

Tipo do documento: cpf, cnpj, rg, passport ou other

documents[].value

string

required

Número do documento sem formatação (apenas dígitos)

Endereços

addresses

array

Lista de endereços do cliente

Show Propriedades

addresses[].type

string

required

Tipo do endereço: billing (cobrança) ou shipping (entrega)

addresses[].postal_code

string

required

CEP (apenas números)

addresses[].line_1

string

required

Logradouro (rua, avenida, etc.)

addresses[].line_2

string

Complemento (apartamento, sala, etc.)

addresses[].number

string

required

Número do endereço

addresses[].neighborhood

string

required

Bairro

addresses[].city

string

required

Cidade

addresses[].state

string

required

Estado (2 caracteres - ex: SP, RJ)

addresses[].country

string

required

País (ISO 3166-1 alpha-2 - ex: BR)

Telefone

phone

object

Informações de contato telefônico

Show Propriedades

phone.type

string

required

Tipo do telefone: mobile, commercial, residential ou public

phone.ddi

string

required

Código do país (ex: 55 para Brasil)

phone.ddd

string

required

Código de área (ex: 11 para São Paulo)

phone.number

string

required

Número do telefone (apenas dígitos)

Exemplo de Requisição

curl -X POST https://zeus-sandbox.autorizou.dev/api/v1/customers \
  -H "Authorization: Bearer 4eC39HqLyjWDarjtT1zdp7dc" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maria da Silva Santos",
    "email": "maria.santos@exemplo.com.br",
    "documents": [
      {
        "type": "CPF",
        "value": "12345678901"
      }
    ],
    "addresses": [
      {
        "type": "billing",
        "postal_code": "01310100",
        "line_1": "Av. Paulista",
        "number": "1000",
        "line_2": "Conjunto 101",
        "neighborhood": "Bela Vista",
        "city": "São Paulo", 
        "state": "SP",
        "country": "BR"
      }
    ],
    "phone": {
      "type": "mobile",
      "ddi": "55",
      "ddd": "11", 
      "number": "987654321"
    }
  }'

Resposta de Sucesso

{
  "id": "142465c6-4c9d-4fd1-9632-2c40af316da3",
  "hash": "AUTCUS01K8RSCH3T5FNB7EVACV8DQVNX",
  "name": "Maria da Silva Santos",
  "email": "maria.santos@exemplo.com.br",
  "created_at": "29/10/2025 17:08:42",
  "updated_at": "29/10/2025 17:08:42"
}

Códigos de Erro

400 - Bad Request

Requisição malformada ou parâmetros inválidos

{
  "error": {
    "code": "invalid_request",
    "message": "Dados da requisição são inválidos"
  }
}

422 - Validation Error

Erro de validação nos dados fornecidos

{
  "message": O email já está em uso.",
  "errors": {
    "email": [
      "O email já está em uso."
    ]
  } 
}

Regras de Negócio

Email único: O email deve ser único por merchant. Tentativas de criar clientes com emails duplicados retornarão erro 422.

Validação de documentos: CPF e CNPJ são validados automaticamente. Apenas documentos válidos são aceitos.

Dados obrigatórios para pagamentos: Embora endereços e telefone sejam opcionais na criação, alguns métodos de pagamento podem exigir essas informações posteriormente.

Próximos Passos

Após criar um cliente, você pode:

Guia Rápido Buscar Cliente

​Casos de Uso

​Parâmetros Obrigatórios

​Parâmetros Opcionais

​Documentos

​Endereços

​Telefone

​Exemplo de Requisição

​Resposta de Sucesso

​Códigos de Erro

​Regras de Negócio

​Próximos Passos

Casos de Uso

Parâmetros Obrigatórios

Parâmetros Opcionais

Documentos

Endereços

Telefone

Exemplo de Requisição

Resposta de Sucesso

Códigos de Erro

Regras de Negócio

Próximos Passos