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

# Realizar pago

> Realiza un pago a 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="provider_id" type="string" required>
  UUID del convenio listado previamente que se desea pagar.
</ParamField>

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

<ParamField body="external_id" type="string">
  Tu propio identificador para el pago (máximo 255 caracteres). Se devuelve en la respuesta y al
  [consultar el pago](/client/utilities/view), para que puedas conciliarlo con tu sistema.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "9d1cd37a-a6bc-472d-b4e6-c913769d005a",
    "group_id": "Kirlin Group, 2381762387",
    "provider_id": "9d1cd37a-94e5-4cf1-aa7c-daac8ebf4ed9",
    "provider_name": "Kirlin Group",
    "amount": 250000,
    "reference": "2381762387",
    "external_id": "FACT-2026-00123",
    "status": "pending",
    "remarks": null
  }
  ```
</ResponseExample>