# Crear una solicitud de pago

Crea una nueva solicitud de pago para un método de pago existente.

> 📘 Claves de Idempotencia
>
> Este método admite claves de idempotencia.

Endpoint: POST /payment_requests
Version: 1.0.0
Security: ApiKeyAuth, ApiKeySecret

## Header parameters:

  - `Idempotency-Key` (string)
    (Opcional, pero altamente recomendado.) Un identificador único para esta solicitud para apoyar la idempotencia. Utiliza un UUID o un identificador similar. Para más información, consulta nuestro artículo dedicado a la Idempotencia.

## Request fields (application/json):

  - `amount` (number, required)
    El monto a debitar del cliente.
    Example: 1000

  - `currency` (string, required)
    El código de moneda de tres letras ISO 4217 de la transacción. Por el momento, solo admitimos mxn.
    Enum: "mxn"

  - `reference` (string, required)
    Su referencia interna para la solicitud de pago.
    Example: "J-789029-PAY-3X"

  - `paymentMethodId` (string, required)
    El identificador único creado por Belvo utilizado para referenciar el método de pago.
    Example: "0d1a377b-b4c5-4a94-9e2e-83e59d1f6a9c"

  - `loanInformation` (object)
    (Metadata opcional) Información sobre el préstamo asociado con la solicitud de pago.

  - `loanInformation.reference` (string)
    Su referencia para el préstamo asociado con la solicitud de pago.
    Example: "Camera Purchase 1432"

  - `loanInformation.disbursementDate` (string)
    La fecha en que se desembolsó el préstamo, en formato YYYY-MM-DD.
    Example: "2025-01-01"

  - `loanInformation.installmentNumber` (integer)
    El número de la cuota que se está pagando.
    Example: 1

  - `loanInformation.installmentAmount` (number)
    El monto de la cuota que se está pagando.
    Example: 100.02

  - `loanInformation.installmentDueDate` (string)
    La fecha de vencimiento de la cuota que se está pagando, en formato YYYY-MM-DD.
    Example: "2025-03-01"

  - `loanInformation.totalAmount` (number)
    El monto total del préstamo.
    Example: 12000.24

  - `loanInformation.totalInstallments` (integer)
    El número total de cuotas para el préstamo.
    Example: 12

## Response 201 fields (application/json):

  - `paymentRequestId` (string)
    El identificador único creado por Belvo utilizado para referenciar la solicitud de pago.
    Example: "0d1a377b-b4c5-4a94-9e2e-83e59d1f6a9c"

## Response 400 fields (application/json):

  - `statusCode` (integer)
    El código de estado HTTP para este error.
    Example: 400

  - `error` (string)
    La descripción del código de estado HTTP para este error.
    Example: "Bad Request"

  - `message` (any)
    Una breve descripción del error, indicando qué está mal con la solicitud.
> Nota: Devolvemos una cadena o un arreglo de cadenas, dependiendo del/los error(es) de validación.

La descripción puede ser (entre otras):

  - id must be a UUID
  - Not enough balance
  - amount is not a valid decimal number.
  - currency must be one of the following values: cop, mxn, usd
  - reference must be a string
  - Customer not found for merchant
  - documentType is a required field
    Example: "id must be a UUID"

## Response 401 fields (application/json):

  - `statusCode` (integer)
    El código de estado HTTP para este error.
    Example: 401

  - `error` (string)
    La descripción del código de estado HTTP para este error.
    Example: "Unauthorized"

  - `message` (string)
    Una breve descripción del error, indicando qué está mal con la solicitud. En el caso de un error 401 Unauthorized, el mensaje es:

  - Unauthorized credentials
    Example: "Unauthorized credentials"

## Response 404 fields (application/json):

  - `statusCode` (integer)
    El código de estado HTTP para este error.
    Example: 404

  - `error` (string)
    La descripción del código de estado HTTP para este error.
    Example: "Not Found"

  - `message` (string)
    Una breve descripción del error, indicando qué está mal con la solicitud. La descripción puede ser (entre otras):

  - Payout Target not found
  - Payment method not found
  - Customer not found
    Example: "Payout Target not found"