Primeros pasos

Módulo

Ventas

Consulta ventas atribuidas por Signal, con estado, producto, valor y origen.

GET/sales
GET/salesAlcance: readOficial + BásicoRequiere plan Oficial o Agency

Lista ventas atribuidas.

Úsalo para dashboards financieros, auditoría de campañas y conciliación. Disponible desde el plan Oficial (por debajo la API responde 403 upgrade_required).

Parámetros de ruta

Sin parámetros adicionales.

Parámetros de query
CampoTipoDescripción
statusopcionalpending | paid | refunded | chargebackFiltra por estado de venta.
sinceopcionalISO date-timeDevuelve ventas creadas desde esta fecha.
limitopcionalnumberCantidad de registros por página. Predeterminado 50; máximo 200 en la mayoría de listas.
offsetopcionalnumberÍndice inicial de la página. Usa pagination.next_offset para la siguiente página.

Campos del cuerpo

Este endpoint no recibe cuerpo JSON.

Ejemplos listos

curl -X GET "https://connect.zyronstack.com/api/v1/sales?status=paid&since=2026-06-01T00:00:00.000Z&limit=20&offset=0" \
  -H "Authorization: Bearer SUA_CHAVE_API"

Respuestas

200Ventas devueltas.
403upgrade_required: el plan actual no incluye la API de ventas.

Ejemplo de respuesta

{
  "data": [
    {
      "id": "91c9fd84-b47f-44ee-9b5e-4e93fc35b912",
      "source": "meta",
      "provider": "kiwify",
      "status": "paid",
      "gross_cents": 19700,
      "fee_cents": 1200,
      "currency": "BRL",
      "product_name": "Produto principal",
      "product_id": "prod_123",
      "conversation_id": "<CONVERSATION_ID>",
      "created_at": "2026-06-15T12:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 12,
    "next_offset": null
  }
}