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

# Crear link de captura

> Crea un nuevo link de captura, para que el cliente pueda registrar su información de pago.

### 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="customer_id" type="string" required placeholder="9dd4158b-0e45-42bc-b56f-a4c1f856814d">
  ID del cliente que completará el formulario. [Ver cómo crear un cliente](/client/customers/create).
</ParamField>

<ParamField body="single_use" type="boolean">
  Define si el enlace de conexión (Connect Link) será de un solo uso o de múltiples usos. Si se establece en true, el enlace será de un solo uso; si es false, permitirá múltiples conexiones.
</ParamField>

<ParamField body="notify" type="boolean">
  Indica si se debe notificar al cliente cuando se complete el pago
</ParamField>

<Note>
  **Métodos de pago permitidos**

  El método de pago disponible depende de la configuración de tu cuenta. Comunícate con el equipo de soporte para habilitar métodos adicionales.

  | Método                    | Campo requerido | Descripción                                     |
  | ------------------------- | --------------- | ----------------------------------------------- |
  | Cuenta bancaria (ACH)     | `account_id`    | Débito directo desde cuenta bancaria registrada |
  | Tarjeta de crédito/débito | `card_id`       | Cargo a tarjeta tokenizada                      |

  Solo uno de los dos (`account_id` o `card_id`) debe estar presente en la petición.
</Note>

<ParamField body="external_id" type="string">
  ID único del cliente en tu sistema
</ParamField>

<ParamField body="redirect_url" type="string">
  URL a la que se redirigirá al cliente después de completar el pago
</ParamField>

<ParamField body="metadata" type="object">
  Metadatos adicionales que deseas asociar con el link
</ParamField>

<ParamField body="redirect_url" type="string" placeholder="https://onepay.la">
  URL de redirección
</ParamField>

### Response

<CustomerResponse />

<ResponseExample>
  ```json 200 theme={null}
  {
      "id": "9e92f61e-e90f-4fbb-a551-080fd4fb4f6f",
      "customer_id": "9957858a-c2f1-4f18-a5c2-216b4127e278",
      "single_use": false,
      "visits": 0,
      "completed": 0,
      "external_id": "31231231231",
      "allows": {
          "cards": true,
          "accounts": true,
          "card_extra": false,
          "realtime": false,
          "pse": true,
          "transfiya": true
      },
      "created_at": "2025-04-01T20:45:16.000000Z",
      "updated_at": "2025-04-01T20:45:16.000000Z",
      "url": "https://pagos.onepay.la/connect-link/9e92f61e-e90f-4fbb-a551-080fd4fb4f6f"
  }
  ```

  ```json 422 theme={null}
  {
    "message": "El campo customer id es obligatorio. (y 1 error más)",
    "code": 10001,
    "code_name": "validation_error",
    "errors": {
      "customer_id": [
        "El campo customer id es obligatorio."
      ],
      "single_use": [
        "El campo single use es obligatorio."
      ]
    }
  }
  ```

  ```json 409 theme={null}
  {
    "message": "No se puede generar la operación, genera un token de idempotencia y envíelo en los headers como x-idempotency",
    "code": 10003,
    "code_name": "idempotency_error"
  }
  ```
</ResponseExample>