---
title: "Crear un LOTE de cobros (N links de una vez)"
method: POST
path: "/switch/v1/lotes"
tags: ["Links de cobro"]
---

# Crear un LOTE de cobros (N links de una vez)

`POST /switch/v1/lotes`

## Request

- Base URL: `https://pay.pagaconquickpay.com`
- URL: `https://pay.pagaconquickpay.com/switch/v1/lotes`
- Auth: API key in header `x-switch-key`

Para cobrarle a una lista de personas: manda hasta 500 items `{monto, concepto, referencia_externa?, cliente?{nombre,telefono}, idempotency_key?}` y recibes un lote con un link por item (misma `url` y `wa_deeplink` de un link normal). Todo-o-nada: si un item no valida, no se crea ninguno. No mueve dinero. `idempotency_key` del lote: el mismo (comercio, key) devuelve el MISMO lote. Cada link nace con su propia llave de idempotencia, así que repetir la petición nunca duplica cobros. Los links expiran a las 24h por defecto (`expira_horas`, 1..720).

## Request body

- object
  - `nombre` string
  - `idempotency_key` string
  - `expira_horas` integer
  - `items` object[], required
    - `monto` number, required
    - `concepto` string, required
    - `referencia_externa` string
    - `cliente` object
      - `nombre` string
      - `telefono` string
    - `idempotency_key` string

## Response `201`

Lote con sus items (link_id, url, wa_deeplink, estado) y resumen

- LoteCreado (unresolved $ref)

## Other responses

- `400`: Validación
- `401`: No autorizado
- `403`: Comercio suspendido (`comercio_suspendido`)
- `409`: idempotency_key de item ya usada

---

[API](https://skmtc.dev/pagaconquickpay/apis/quickpay-api.md) · [All operations](https://skmtc.dev/pagaconquickpay/apis/quickpay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pagaconquickpay/apis/quickpay-api/revisions/999597fa67f3?raw)