Endpoint: GET /event/seller/{account_id}/events/{events_pk}/checkouts/
Autenticação: JWT obrigatório ou Chave de API aceita.
Lista todos os checkouts do evento, ordenados por -created_at, já com os dados de cliente e cupom resolvidos. Permite filtrar por status e buscar por nome ou e-mail do cliente.

​
Pré-requisitos

  • O evento precisa existir sob {account_id}.

​
Parâmetros de path

​
account_id
string (uuid)
required
​
events_pk
string (uuid)
required

​
Parâmetros de query

​
status
string
Correspondência exata. Um dos valores: EXPIRED, FREE, PENDING, PAID, CANCELED.
​
search
string
Busca textual (contém, sem diferenciação de maiúsculas/minúsculas) em customer.name ou customer.email.

​
Resposta

200 OK com um array de checkouts. Esta rota não paginada — todos os registros que casarem com o filtro são retornados.
​
id
string (uuid)
​
customer
object
name, email, phone_number, country_code.
​
ticket_count
integer
Quantidade de ingressos no pedido.
​
coupon
object | null
Cupom aplicado (se houver): id, name, code, type, value.
​
status
string
EXPIRED, FREE, PENDING, PAID ou CANCELED.
​
total
integer
Valor final em centavos de BRL.
​
original_total
integer
Valor total antes do desconto, em centavos de BRL.
​
discount_amount
integer
Valor do desconto, em centavos de BRL.
​
created_at
string
​
updated_at
string
[
  {
    "id": "7b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e",
    "customer": {
      "name": "Maria Silva",
      "email": "maria@example.com",
      "phone_number": "11987654321",
      "country_code": "+55"
    },
    "ticket_count": 2,
    "coupon": {"id": "...","name":"10%","code":"SUNSET10","type":"PERCENTAGE","value":10},
    "status": "PAID",
    "total": 21600,
    "original_total": 24000,
    "discount_amount": 2400,
    "created_at": "2026-05-14T12:30:00Z",
    "updated_at": "2026-05-14T12:31:05Z"
  }
]

​
Ações relacionadas

  • GET /.../checkouts/report/ — exportação em CSV/Excel/Texto, com uma linha por ingresso (Accept: text/csv, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet ou text/plain). Inclui respostas das perguntas como colunas [P] <pergunta>.
  • GET /.../checkouts/financial-report/ — exportação em CSV/Excel/Texto com dados financeiros (MDR, líquido, recebíveis) cruzando transações e recebíveis.
  • POST /.../checkouts/{id}/resend-email/ — corpo {"email": "..."} (opcional, sobrescreve o destinatário). Reenviar o PDF do ingresso e a confirmação. Exige is_paid.
  • POST /.../checkouts/validate-ticket/ — corpo {"ticketCheckoutId": "..."}. Marca o ingresso como utilizado; rejeita quando ainda não foi pago ou quando já foi usado.

​
Erros

StatusQuando
401Token ausente ou inválido.

​
Exemplos

curl "https://api.dlpay.cloud/event/seller/$ACCOUNT_ID/events/$EVENT_ID/checkouts/?status=PAID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"