> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/api-rest/identity-api/identity-api-reference/onboarding/civil-registry/dha/crear-cliente.md).

# Crear cliente

Permite crear un cliente antes de realizar cualquiera de las verificaciones y validaciones del consumidor en el registro **DHA** de Sudáfrica 🇿🇦.

### Endpoint

```
POST /civil-registry/dha/customers
```

### Autenticación

| Tipo    | Ubicación | Nombre        |
| ------- | --------- | ------------- |
| API Key | Header    | **x-api-key** |

### Cuerpo de la solicitud

**Content-Type:** `application/json`

#### Parámetros

| Parámetro              | Tipo    | Requerido | Descripción                                                                                                                                                                       |
| ---------------------- | ------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id_type`              | string  | **Sí**    | Tipo de identificación. Valores posibles: `id_number`, `passport`                                                                                                                 |
| `id_number`            | string  | **Sí**    | Número de identificación sudafricano de **13 dígitos**.                                                                                                                           |
| `first_name`           | string  | **Sí**    | Nombre del cliente tal como aparece en su documento de identidad.                                                                                                                 |
| `middle_name`          | string  | **Sí**    | Segundo nombre del cliente tal como aparece en su documento de identidad.                                                                                                         |
| `last_name`            | string  | **Sí**    | Apellido del cliente tal como aparece en su documento de identidad.                                                                                                               |
| `email`                | string  | **Sí**    | Dirección de correo electrónico del cliente. Debe tener el formato `ejemplo@123.com`                                                                                              |
| `client_reference`     | string  | **Sí**    | Referencia que se puede utilizar para identificar y buscar al cliente en su sistema. Cada cliente debe tener un `client_reference` **único**.                                     |
| `country`              | string  | No        | Nacionalidad del cliente.                                                                                                                                                         |
| `popi`                 | boolean | **Sí**    | Indica si el cliente ha dado su consentimiento bajo la Ley de Protección de Información Personal (POPI) para continuar con la recopilación de datos y verificaciones adicionales. |
| `terms_and_conditions` | boolean | **Sí**    | Indica si el cliente ha aceptado los Términos y Condiciones de la Aplicación y las Verificaciones que se están realizando.                                                        |

#### Ejemplo de solicitud

```bash
curl --location '{IDENTITY_API_BASE_URL}/civil-registry/dha/customers' \
--data-raw '{
    "id_type": "id_number",
    "id_number": "9999999999999",
    "client_reference": "clientnumber1",
    "email": "walter.w@facephi.com",
    "first_name": "Walter",
    "middle_name": "Hartwell",
    "last_name": "White",
    "popi": true,
    "terms_and_conditions": true,
    "country": null
}' \
--header 'x-api-key: {API_KEY}'
```

### Respuestas

#### `200` Éxito

#### Ejemplo de respuesta

```json
{
    "id": "16cd33d2-cf0a-66ad-8150-cb39e9b9ff27",
    "client_reference": "clientnumber1",
    "popi": null,
    "terms_and_conditions": null,
    "email": "walter.w@facephi.com",
    "id_number": "9999999999999",
    "first_name": "Walter",
    "middle_name": "Hartwell",
    "last_name": "White",
    "full_name": "Walter Hartwell White",
    "id_type": "id_number",
    "country": null,
    "initials": "WHW"
}
```

#### `400` Bad Request

```json
{
  "status": 400,
  "title": "Bad Request",
  "detail": "Invalid request.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/400",
  "errors": []
}
```

#### `401` Unauthorized

```json
{
  "message": "Unauthorized"
}
```

#### `403` Forbidden

```json
{
  "Message": "User is not authorized to access this resource with an explicit deny"
}
```

#### `502` Bad Gateway

```json
{
  "status": 502,
  "title": "Bad Gateway",
  "detail": "Server got an invalid response.",
  "type": "https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/502"
}
```

#### `504` Gateway Timeout

```json
{
  "message": "Endpoint request timed out"
}
```