Vendas - Documentação Assiny

Listar vendas

GET /financial/bff/project/transaction?projectId={projectId}

Devolve as vendas do projeto em páginas. Os filtros são os mesmos da tela de Vendas do painel e vão como parâmetros na URL:

Parâmetro	Descrição
`projectId`	Obrigatório. Projeto das vendas.
`limit`, `offset`	Paginação: quantas vendas por página e quantas pular.
`startDate`, `endDate`	Período de criação da venda.
`updatedAtStartDate`, `updatedAtEndDate`	Período da última atualização. Use para buscar só o que mudou desde a última consulta: pagamentos aprovados, reembolsos, chargebacks.
`status`	`paid`, `pending`, `waiting_payment`, `refunded`, `refused`, `chargedback`, `chargedback_refunded`, `pix_expired`, `request_refund`, `sent_to_refund`, `refunded_by_client`.
`paymentTypes`	`CREDIT`, `PIX`, `BANK_SLIP`.
`offerTypes`	`ENTRY`, `UPSELL`, `DOWNSELL`, `ORDERBUMP`.
`products`, `offers`, `funnels`	IDs de produtos, ofertas e funis.
`clientEmail`, `clientDocument`, `nameEmailClient`	Busca por e-mail, CPF/CNPJ ou nome/e-mail do comprador.
`utmSource`, `utmMedium`, `utmCampaign`, `utmTerm`, `utmContent`, `src`	Origem da venda.

curl

curl "https://bff.assiny.com.br/v1/public/financial/bff/project/transaction?projectId=SEU_PROJECT_ID&status=paid&startDate=2026-11-01T00:00:00-03:00&endDate=2026-11-01T23:59:59-03:00&limit=50&offset=0" \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "ProjectId: SEU_PROJECT_ID"

Para manter o seu banco em dia, consulte por updatedAtStartDate e updatedAtEndDate a partir da última execução e pagine com limit e offset até acabar. Assim você pega também as vendas antigas que mudaram de status.

Detalhe de uma venda

GET /financial/bff/sale/details/{transactionId}

Dados completos da venda: status, valores (amount, amountWithTax), forma de pagamento e parcelas, comprador (nome, e-mail, telefone, CPF), produto e oferta, funil, UTMs, cupom, frete, endereço, order bumps e, se for assinatura, o subscriptionId.