> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onepay.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Generar link de pago

> Genera un link de pago para un convenio.

### Headers

<ParamField header="x-idempotency" type="string" required placeholder="Token único para garantizar la idempotencia de la petición">
  Token único para garantizar la idempotencia de la petición
</ParamField>

### Body

<ParamField body="reference" type="string" required>
  Referencia de pago para el convenio. de ejemplo puedes usar 111100005555
</ParamField>

<ParamField body="amount" type="number">
  Monto de pago para el convenio, es opcional si no se envia se consultaran los servicios disponibles para obtener el monto.
</ParamField>

<ParamField body="redirect_url" type="string">
  URL a la que se redirigira el usuario luego de pagar.
</ParamField>

<ParamField body="customer" type="object">
  Objeto con los datos del cliente.

  <ParamField body="first_name" type="string">
    Nombre del cliente.
  </ParamField>

  <ParamField body="last_name" type="string">
    Apellido del cliente.
  </ParamField>

  <ParamField body="email" type="string">
    Email del cliente \[opcional].
  </ParamField>

  <ParamField body="phone" type="string">
    Telefono del cliente en formato E.164.
  </ParamField>

  <ParamField body="document_type" type="string">
    Tipo de documento del cliente \[CC, CE, TI, NIT, PPT]
  </ParamField>

  <ParamField body="document_number" type="string">
    Número de documento del cliente.
  </ParamField>
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "d7e214b7-75c1-427f-a810-4e4a4fb01cd4",
    "redirect_url": "https://pagos.onepay.la/payment/d7e214b7-75c1-427f-a810-4e4a4fb01cd4"
  }
  ```
</ResponseExample>