# Crear una nueva Payment Intent

Crear una Intención de Pago.

Puedes crear una Intención de Pago en las siguientes configuraciones:

  |Beneficiario|Cliente (Pagador)|Ejemplo|
  |---|---|---|
  |Clave Pix|Ya registrado con Belvo|Clave Pix (Con Cliente Existente)|
  |Clave Pix|Registrar con Belvo en el momento de la solicitud de Intención de Pago|Clave Pix (Con Nuevo Cliente)|
  |Cuenta Bancaria (Ya Registrada)|Ya Registrado|Cuenta Bancaria (Con Cliente Existente)|
  |Cuenta Bancaria (Ya Registrada)|Registrar con Belvo en el momento de la solicitud de Intención de Pago|Cuenta Bancaria (Con Nuevo Cliente)|
  |Cuenta Bancaria (Registrar en el momento de la solicitud de Intención de Pago)|Registrar con Belvo en el momento de la solicitud de Intención de Pago|Cuenta Bancaria (Con Nuevo Cliente y Cuenta Bancaria del Beneficiario)|

  {% admonition type="warning" name="Pagos Pix" %}
    Cuando creas Intenciones de Pago usando una Clave Pix, debes realizar una solicitud PATCH Complete a Payment Intent para completar la creación de la Intención de Pago.
  {% /admonition %}

Endpoint: POST /payments/br/payment-intents/
Version: 1.223.0
Security: basicAuth

## Header parameters:

  - `Belvo-Idempotency-Key` (string)
    Un UUID para asegurar solicitudes idempotentes. Esta clave ayuda a prevenir operaciones duplicadas al permitir que el servidor reconozca solicitudes repetidas con la misma clave y devuelva la respuesta original en lugar de procesar la solicitud nuevamente.

{% admonition type="info" name="Altamente Recomendado" %}
  Recomendamos encarecidamente incluir este encabezado en cualquier solicitud donde desee asegurar la idempotencia, como al crear recursos o realizar acciones que no deben duplicarse.
{% /admonition %}

Puede recibir los siguientes errores en caso de que haya un problema con su solicitud:

- 409 Conflict: Si una solicitud anterior aún se está procesando con la misma clave de idempotencia. Verifique el encabezado de respuesta Belvo-Idempotency-Status para conocer el estado actual de esa clave de idempotencia.
- 422 Unprocessable Entity: Si una nueva solicitud utiliza una clave de idempotencia que se ha utilizado previamente en otra solicitud que contiene una carga útil diferente. En este caso, debe cambiar la clave de idempotencia a un nuevo valor único.

{% admonition type="warning" name="En Beta" %}
  Esta función está actualmente en Beta y solo está disponible para clientes seleccionados. Si encuentra algún problema o está interesado en usar esta función, comuníquese con su representante de Belvo.
{% /admonition %}
    Example: "82737f32-7730-4832-a985-dd86df70301c"

## 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 409 fields (application/json):

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

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

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

  - Una solicitud con esta idempotency key ya está siendo procesada.
    Example: "A request with this idempotency key is already being processed."

  - `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"

## Response 422 fields (application/json):

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

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

Para los errores idempotency_payload_mismatch, la descripción es:

  - Ya existe una solicitud diferente con la misma clave de idempotencia.
    Example: "A different request with the same idempotency key already exists."

  - `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"

## 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"