# Customer

```json
{
  "type": "object",
  "required": [
    "id",
    "name",
    "email",
    "cpf",
    "cnpj"
  ],
  "properties": {
    "id": {
      "description": "O id do cliente na NinePay. Obrigatório se os demais dados do usuário não forem informados",
      "type": "integer",
      "example": 42,
      "readOnly": true
    },
    "name": {
      "description": "O nome do cliente. Obrigatório se o `id` não for informado",
      "type": "string",
      "example": "Jhon Doe"
    },
    "email": {
      "description": "O email do cliente. Obrigatório se o `id` não for informado",
      "type": "string",
      "example": "jhon@doe.com"
    },
    "cpf": {
      "description": "O cpf do cliente. Obrigatório se o `id` ou o `cnpj` não forem informados",
      "type": "string",
      "example": "833.828.600-15"
    },
    "cnpj": {
      "description": "O cnpj do cliente. Obrigatório se o `id` ou o `cpf` não forem informados",
      "type": "string",
      "example": "95.135.209/0001-79"
    },
    "phone": {
      "description": "O telefone celular do cliente, com DDD. Obrigatório para cobranças no cartão de crédito.",
      "type": "string",
      "example": "(11) 11111-1111"
    },
    "cep": {
      "description": "O CEP do cliente. Obrigatório para cobranças no cartão de crédito.",
      "type": "string",
      "example": "01423-910"
    },
    "address": {
      "description": "O endereço do cliente",
      "type": "string",
      "example": "Rua José Maria Lisboa"
    },
    "number": {
      "description": "O número do endereço do cliente. Obrigatório para cobranças no cartão de crédito.",
      "type": "string",
      "example": 42
    },
    "district": {
      "description": "O bairro do cliente",
      "type": "string",
      "example": "Jardim Paulista"
    },
    "city": {
      "description": "A cidade do cliente",
      "type": "string",
      "example": "São Paulo"
    },
    "state": {
      "description": "O estado do cliente",
      "type": "string",
      "example": "SP"
    },
    "country": {
      "description": "O código do país do cliente, no formato Alpha 2 de acordo com a [ISO 3166](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes).",
      "type": "string",
      "example": "BR"
    }
  }
}
```
