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.

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
}

Campos

string

pending — esperando el pago, 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.

string

Cómo se vendió: mercadopago, stripe, recurrente, bank_transfer, whatsapp, free, staff.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). 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.

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

Empezar

Referencia

Webhooks

Ventas

Ventas

Listar ventas

Parámetros

Consultar una venta

El objeto Orden

Campos

`attendees[]` (solo en el detalle)

​Ventas

​Listar ventas

​Parámetros

​Consultar una venta

​El objeto Orden

​Campos

​attendees[] (solo en el detalle)

Ventas

Listar ventas

Parámetros

Consultar una venta

El objeto Orden

Campos

`attendees[]` (solo en el detalle)