Ventas

Una orden es una compra: quién compró, qué se llevó, cuánto pagó, por qué canal y en qué estado quedó. Requiere el permiso ORDERS_READ.

Este endpoint devuelve datos personales de tus compradores (nombre, email, teléfono, documento). Tratalos con el mismo cuidado con el que los tratás en el dashboard.

Listar ventas

GET /api/v1/orders

curl "https://qrticket.app/api/v1/orders?event_id=m94K1zLU8S&status=completed&limit=200" \
  -H "Authorization: Bearer qrt_live_..."

Parámetros

Parámetro	Tipo	Descripción
`limit`	número	1 a 200. Default 50.
`cursor`	texto	Cursor de la página anterior.
`event_id`	texto	Solo las ventas de ese evento.
`status`	texto	`pending`, `completed`, `failed`, `refunded`, `cancelled`. Repetible o separado por comas.
`created_after`	fecha	Creadas a partir de esta fecha.
`created_before`	fecha	Creadas hasta esta fecha.
`updated_after`	fecha	Modificadas después de esta fecha. Es el parámetro para sincronizar.

Las compras de créditos (lo que la productora nos paga a nosotros) no aparecen acá. Este feed son tus ventas de entradas, nada más.

Consultar una venta

GET /api/v1/orders/{order_id}

Devuelve lo mismo que la lista más attendees[], con las credenciales de cada asistente.

Aprobar una venta

POST /api/v1/orders/{order_id}/approve

curl -X POST "https://qrticket.app/api/v1/orders/OwcEMGo0jm/approve" \
  -H "Authorization: Bearer qrt_live_..."

Aprueba una venta por transferencia bancaria (bank_transfer) o un pedido por WhatsApp (whatsapp) que está esperando tu revisión, igual que el botón «Aprobar» del dashboard: se emiten las entradas, se descuentan tus créditos y le llegan por mail al comprador. Requiere el permiso ORDERS_WRITE. Responde con la venta ya aprobada, con la misma forma que consultar una venta.

Se aprueban las ventas en pending. Una transferencia rechazada por error (cancelled) también se puede aprobar, como desde el dashboard.
Si la venta ya estaba aprobada, responde 200 con la venta tal como está y no emite nada de nuevo: si se te cortó la conexión, podés repetir la llamada sin miedo.
Sin créditos suficientes para emitir las entradas responde 409 insufficient_credits y la venta sigue pendiente.

Rechazar una venta

POST /api/v1/orders/{order_id}/reject

curl -X POST "https://qrticket.app/api/v1/orders/OwcEMGo0jm/reject" \
  -H "Authorization: Bearer qrt_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "reason": "El comprobante no corresponde al importe." }'

Campo	Tipo	Descripción
`reason`	texto	Obligatorio, hasta 500 caracteres. En una transferencia, el comprador lo recibe por mail. Queda en `payment.rejection_reason`.

Rechaza una venta en pending, igual que «Rechazar» en el dashboard: las entradas que reservaba vuelven a estar a la venta y, si era por transferencia, le avisamos al comprador por mail con el motivo. Dispara el webhook order.rejected. Requiere el permiso ORDERS_WRITE y responde con la venta. Si ya estaba rechazada, responde 200 con la venta tal como está.

Errores al aprobar o rechazar

Código HTTP	`code`	Qué pasó
400	`invalid_request`	Falta `reason` al rechazar, o el cuerpo no es JSON.
403	`insufficient_scope`	La clave no tiene `ORDERS_WRITE`.
404	`not_found`	La venta no existe o no es de tu productora.
409	`order_not_manual`	No es una venta por transferencia bancaria ni por WhatsApp: esas se aprueban solas al pagarse.
409	`order_not_pending`	Ya se decidió de otra forma (por ejemplo, rechazar una venta aprobada).
409	`insufficient_credits`	No hay créditos para emitir las entradas.

Cómo enterarte de las ventas a revisar: consultá GET /orders?status=pending&updated_after=… cada tanto. Las que tienen channel bank_transfer o whatsapp son las que esperan tu decisión. El comprobante está en payment.transfer_proof_url.

El objeto Orden

{
  "id": "OwcEMGo0jm",
  "event_id": "m94K1zLU8S",
  "event": { "id": "m94K1zLU8S", "name": "EUFORIA", "slug": "euforia" },
  "status": "completed",
  "channel": "mercadopago",
  "provider": "mercadopago",
  "amount": 28000,
  "currency": "ARS",
  "discount_amount": 2000,
  "coupon_code": "AMIGOS",
  "buyer": {
    "name": "Camila Ríos",
    "email": "camila@example.com",
    "phone": "+5493411234567",
    "identity_document": "38123456"
  },
  "seller": {
    "id": "cm11286mg...",
    "name": "Josué",
    "email": "josue@example.com",
    "referral_id": "aB3dE5fG7h"
  },
  "items": [
    {
      "id": "cmptftf3v0002",
      "kind": "ticket_type",
      "ticket_type_id": "TvEPjMm1rx",
      "name": "PREVENTA",
      "unit_price": 14000,
      "quantity": 2,
      "total_price": 28000
    }
  ],
  "attendee_count": 2,
  "payment": {
    "external_id": "1234567890",
    "transfer_proof_url": null,
    "rejection_reason": null
  },
  "utm": { "source": "instagram", "medium": "cpc", "campaign": "euforia", "content": null, "term": null },
  "created_at": "2026-08-01T18:04:11.000Z",
  "updated_at": "2026-08-01T18:05:02.000Z",
  "refunded_at": null,
  "combo_parent_order_id": null
}

Campos

string

pending — esperando el pago (en una transferencia automática, que el comprador transfiera al alias de la compra), o esperando que el organizador apruebe una transferencia / un pedido por WhatsApp. Todavía no hay entradas emitidas.
completed — pagada y con las entradas emitidas.
failed — el pago fue rechazado.
refunded — se devolvió la plata; las credenciales quedaron anuladas.
cancelled — se rechazó o se anuló antes de emitir (también una transferencia automática cuyo alias venció sin recibir el pago).

string

Cómo se vendió: mercadopago, stripe, recurrente, dlocal, automatic_transfer, bank_transfer, whatsapp, free, staff.automatic_transfer es la transferencia automática (alias propio por compra, se aprueba sola al acreditarse); bank_transfer la transferencia con comprobante que aprueba el organizador. staff es una carga manual del equipo (o una importación), free es una entrada gratuita reclamada online. Este es el campo para agrupar por canal — es el mismo criterio que usa el dashboard.

number

Lo que efectivamente pagó el comprador, ya con el descuento aplicado y, si el evento traslada la comisión del procesador, con ese recargo incluido.

object | null

El RRPP o vendedor al que se le atribuye la venta, cuando entró por su link de referido o la generó él mismo. null si fue una venta directa.

array

Las líneas de la compra, con el precio que se cobró en ese momento. kind es ticket_type o bundle, y ticket_type_id apunta al ítem correspondiente en tipos de entrada.

number

Cuántas personas trae la orden, que no es lo mismo que cuántos QRs: un combo emite varias credenciales para el mismo asistente. Para contar credenciales, mirá entradas.

string | null

La referencia del pago en el procesador (id de MercadoPago, PaymentIntent de Stripe, intent de Recurrente, id del pago de dLocal, id del pago de la transferencia automática). Sirve para conciliar contra el extracto del procesador. Nunca devolvemos tokens ni credenciales de cobro.

string

Se mueve cada vez que la orden cambia de estado. Es el campo para updated_after.

string | null

Combo de varias fechas (por ejemplo, Navidad + Año Nuevo). El combo se paga en un evento, y cada otra fecha recibe su propia orden con sus asistentes y credenciales. En esa orden, este campo es el id de la orden que se pagó. Su amount es la parte de esa fecha, que el amount de la orden pagada ya incluye: al sumar plata, salteá las órdenes con este campo. Se reembolsa junto con la orden pagada. null en el resto.

`attendees[]` (solo en el detalle)

{
  "attendees": [
    {
      "id": "qtRD9AfcaF",
      "name": "Camila Ríos",
      "email": "camila@example.com",
      "phone": null,
      "identity_document": "38123456",
      "created_at": "2026-08-01T18:05:02.000Z",
      "tickets": [ { "id": "2vLwQ8GE135z", "status": "valid", "...": "..." } ]
    }
  ]
}

Cada elemento de tickets tiene la misma forma que en entradas.

Si el evento pide datos por entrada (configuración “Datos de los asistentes”), la orden trae un elemento de attendees[] por persona, cada uno con su propio nombre, documento y email. En eventos que solo piden los datos del comprador, la orden trae un único asistente con todas las credenciales — el comportamiento histórico.

Empezar

Referencia

Webhooks

Ventas

Ventas

Listar ventas

Parámetros

Consultar una venta

Aprobar una venta

Rechazar una venta

Errores al aprobar o rechazar

El objeto Orden

Campos

`attendees[]` (solo en el detalle)

Ventas

Listar ventas

Parámetros

Consultar una venta

Aprobar una venta

Rechazar una venta

Errores al aprobar o rechazar

El objeto Orden

Campos

attendees[] (solo en el detalle)

`attendees[]` (solo en el detalle)