Vendas — API Zyron Connect Suite

GET/salesEscopo: readOficial + BásicoRequer plano Oficial ou Agency

Lista vendas atribuídas.

Use para dashboards financeiros, auditoria de campanhas e conciliação de vendas. Disponível a partir do plano Oficial (abaixo disso a API responde 403 upgrade_required).

Parâmetros de caminho

Sem parâmetros adicionais.

Parâmetros de query

Campo	Tipo	Descrição
`status`opcional	pending \| paid \| refunded \| chargeback	Filtra por status da venda.
`since`opcional	ISO date-time	Retorna vendas criadas a partir desta data.
`limit`opcional	number	Quantidade de registros por página. Padrão 50; máximo 200 na maioria das listas.
`offset`opcional	number	Índice inicial da página. Use pagination.next_offset para buscar a próxima página.

Campos do corpo

Este endpoint não recebe corpo JSON.

Exemplos prontos

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"

Respostas

200	Vendas retornadas.
403	upgrade_required: o plano atual não inclui a API de vendas.

Exemplo de resposta

{
  "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
  }
}