# Crear un nuevo cliente

Cree un nuevo cliente para enviar o solicitar fondos.

Endpoint: POST /payments/br/customers/
Version: 1.223.0
Security: basicAuth

## Header parameters:

  - `X-Belvo-API-Resource-Version` (string)
    Encabezado que indica qué versión de la API de Pagos deseas utilizar. Actualmente, esto solo es aplicable para Cuentas Bancarias, Clientes y Autorizaciones de Pago en Brasil. En el caso de que estés utilizando nuestro producto de Autorizaciones de Pago, entonces debes enviar este encabezado configurado en Payments-BR.V2.

{% admonition type="warning" name="Próximamente" %}
  Esta versión está en Próximamente. Por lo tanto, pueden ocurrir cambios menores o errores. Si encuentras algún problema, por favor contacta a tu representante de Belvo.
{% /admonition %}
    Enum: "Payments-BR.V2"

## Request fields (application/json):

  - `body` (object) — one of:
    - V2 - Crear Cliente:
      - `identifier` (string, required)
        El CPF (11 dígitos) o CNPJ (14 dígitos) del cliente.
        Example: "12345678901122"
      - `name` (string, required)
        El nombre completo o nombre comercial del cliente.
        Example: "Frangos Enlatados"
      - `external_id` (string)
        Un identificador único adicional para el recurso con fines internos.

{% admonition type="success" name="Altamente Recomendado" %}
  Recomendamos usar este campo para almacenar su propio identificador único para cada recurso (cliente, cuenta bancaria, intención de pago o inscripción). Esto puede ser útil para rastrear el recurso en su sistema y para fines de depuración.
{% /admonition %}
        Example: "4b8a81a0-e33c-45a6-8567-479efb105f73"
    - V1 - Crear Cliente:
      - `identifier` (string, required)
        El número de CPF o CNPJ del cliente.
        Example: "10187609363"
      - `name` (string)
        El nombre completo del cliente que deseas crear.
        Example: "Gustavo Veloso"
      - `external_id` (string)
        Un identificador único adicional para el recurso con fines internos.

{% admonition type="success" name="Altamente Recomendado" %}
  Recomendamos usar este campo para almacenar su propio identificador único para cada recurso (cliente, cuenta bancaria, intención de pago o inscripción). Esto puede ser útil para rastrear el recurso en su sistema y para fines de depuración.
{% /admonition %}
        Example: "4b8a81a0-e33c-45a6-8567-479efb105f73"
      - `email` (string)
        La dirección de correo electrónico del cliente.
        Example: "gustavo.veloso@musicabrazil.br"
      - `phone` (string,null)
        El número de teléfono del cliente.
        Example: "+5511987654321"
      - `address` (string,null)
        La dirección física del cliente.
        Example: "Rua de Gustavo Veloso 432, 70200 Brasilia"

## Response 201 fields (application/json):

  - `body` (object) — one of:
    - V2 - Cliente:
      - `id` (string, required)
        Identificador único de Belvo para el elemento actual.
        Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"
      - `created_at` (string, required)
        La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
        Example: "2022-02-09T08:45:50.406032Z"
      - `updated_at` (string, required)
        La marca de tiempo ISO-8601 de cuando el punto de datos fue actualizado en la base de datos de Belvo.
        Example: "2022-02-09T08:45:50.406032Z"
      - `name` (string, required)
        El nombre completo o nombre comercial del cliente.
        Example: "Frangos Enlatados"
      - `identifier` (string, required)
        El CPF (11 dígitos) o CNPJ (14 dígitos) del cliente.
        Example: "12345678901122"
      - `external_id` (string)
        Un identificador único adicional para el recurso con fines internos.

{% admonition type="success" name="Altamente Recomendado" %}
  Recomendamos usar este campo para almacenar su propio identificador único para cada recurso (cliente, cuenta bancaria, intención de pago o inscripción). Esto puede ser útil para rastrear el recurso en su sistema y para fines de depuración.
{% /admonition %}
        Example: "4b8a81a0-e33c-45a6-8567-479efb105f73"
    - V1 - Cliente:
      - `id` (string, required)
        Identificador único de Belvo para el elemento actual.
        Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d"
      - `created_at` (string, required)
        La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo.
        Example: "2022-02-09T08:45:50.406032Z"
      - `created_by` (string, required)
        El ID único para el usuario que creó este elemento.
        Example: "bcef7f35-67f2-4b19-b009-cb38795faf09"
      - `customer_type` (string, required)
        El tipo de cliente. Puede ser:

  - INDIVIDUAL
  - BUSINESS (solo para OFPI de Brasil)
        Enum: "INDIVIDUAL", "BUSINESS"
      - `name` (string,null, required)
        El nombre completo del cliente.
        Example: "Gustavo Veloso"
      - `external_id` (string)
        Un identificador único adicional para el recurso con fines internos.

{% admonition type="success" name="Altamente Recomendado" %}
  Recomendamos usar este campo para almacenar su propio identificador único para cada recurso (cliente, cuenta bancaria, intención de pago o inscripción). Esto puede ser útil para rastrear el recurso en su sistema y para fines de depuración.
{% /admonition %}
        Example: "4b8a81a0-e33c-45a6-8567-479efb105f73"
      - `country` (string,null, required)
        El país de residencia del cliente.
-  BRA (🇧🇷 Brasil)
        Enum: "BRA", "null"
      - `email` (string,null, required)
        La dirección de correo electrónico del cliente.
        Example: "gustavo.veloso@musicabrazil.br"
      - `identifier` (string, required)
        El número de documento de la identificación del cliente (dependiendo del identifier_type).
        Example: 191
      - `identifier_type` (string, required)
        El tipo de documento de identificación del cliente. Para Brasil, esto puede ser:

- CPF (cuando customer_type es INDIVIDUAL)
- CNPJ (cuando customer_type es BUSINESS)
        Enum: "CPF", "CNPJ"
      - `address` (string,null)
        La dirección física del cliente.
        Example: "Rua de Gustavo Veloso 432, 70200 Brasilia"
      - `phone` (string,null)
        El número de teléfono del cliente.
        Example: "+5511987654321"

## Response 400 fields (application/json):

  - `code` (string, required)
    Un código de error único (null, does_not_exist, required, already_registered, invalid_choice, max_length, min_length, blank, null, cancellation_error, idempotency_key_invalid) que te permite clasificar y manejar el error de manera programática.
    Example: "required"

  - `message` (string, required)
    Una breve descripción del error.

La descripción puede ser (entre otras):

  - Este campo es obligatorio.
  - El objeto con nombre=narnia no existe.
  - Este campo no puede ser nulo.
  - Este campo no puede estar en blanco.
  - Este cliente ya está registrado.
  - Asegúrese de que este campo tenga al menos 2 caracteres.
  - Asegúrese de que este campo no tenga más de 4 caracteres.
  - El valor ingresado no es válido.
  - Debe establecer todos los campos obligatorios: username, password, username_type.
  - Payment Intent no puede ser cancelado porque no está SCHEDULED.
  - Payment Intent no puede ser cancelado ya que el tiempo límite (23:59:00) ha pasado.
  - La clave de idempotencia proporcionada no es válida.
    Example: "This field is required."

  - `request_id` (string, required)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

  - `field` (string,null)
    Nombre del campo donde se encontró el error.

> Nota: Este campo solo está presente cuando el error está relacionado con un campo específico.
    Example: "institution"

## Response 403 fields (application/json):

  - `code` (string)
    Un código de error único (access_to_resource_denied) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar 403 access_to_resource_denied.
    Example: "access_to_resource_denied"

  - `message` (string)
    Una breve descripción del error.

Para los errores access_to_resource_denied, la descripción es:

  - You don't have access to this resource..
    Example: "You don't have access to this resource."

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 404 fields (application/json):

  - `code` (string)
    Un código de error único (not_found) que te permite clasificar y manejar el error de manera programática.
    Example: "not_found"

  - `message` (string)
    Una breve descripción del error.

Para errores not_found, la descripción es:

  - Not found
    Example: "Not found"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 408 fields (application/json):

  - `code` (string)
    Un código de error único (request_timeout) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 408 request_timeout.
    Example: "request_timeout"

  - `message` (string)
    Una breve descripción del error.

Para los errores de request_timeout, la descripción es:

  - The request timed out, you can retry asking for less data by changing your query parameters.
    Example: "The request timed out, you can retry asking for less data by changing your query parameters"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"

## Response 500 fields (application/json):

  - `code` (string)
    Un código de error único (unexpected_error) que te permite clasificar y manejar el error de manera programática.

ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 500 unexpected_error.
    Example: "unexpected_error"

  - `message` (string)
    Una breve descripción del error.

Para los errores unexpected_error, la descripción es:

- Belvo no puede procesar la solicitud debido a un problema interno del sistema o a una respuesta no soportada de una institución.
    Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution"

  - `request_id` (string)
    Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: [a-f0-9]{32}). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones.
    Example: "9e7b283c6efa449c9c028a16b5c249fb"