# IngressoJá

> Plataforma brasileira de venda de ingressos para shows e eventos, com API para organizadores (eventos, pedidos, ingressos, check-in e webhooks) e API de pagamentos PIX para parceiros que usam o IngressoJá como gateway.

Base da API: https://api.ingressoja.com/v1. Valores em centavos na API de eventos e em reais na API de pagamentos. Datas em ISO 8601 (UTC).

## Documentação

- [Documentação completa em Markdown](https://ingressoja.com/llms-full.txt): tudo numa página só, ideal para colar no contexto
- [Documentação (página)](https://ingressoja.com/docs): a mesma coisa com exemplos em cURL, Node.js, Python e PHP
- [OpenAPI 3.1](https://ingressoja.com/docs/openapi.json): contrato para Postman, Insomnia e geradores de código

## API de eventos e ingressos

- [Listar eventos](https://ingressoja.com/docs#list-events): `GET /events` Eventos da sua conta, do mais próximo para o mais distante.
- [Buscar evento](https://ingressoja.com/docs#get-event): `GET /events/{id}` Um evento com os setores, preços (em centavos), vendidos e disponíveis.
- [Listar pedidos](https://ingressoja.com/docs#list-orders): `GET /events/{id}/orders` Pedidos do evento, do mais recente para o mais antigo, com comprador, itens, valores e origem (UTM).
- [Buscar pedido](https://ingressoja.com/docs#get-order): `GET /events/{id}/orders/{orderId}` Um pedido com todos os ingressos emitidos.
- [Listar ingressos](https://ingressoja.com/docs#list-tickets): `GET /events/{id}/tickets` Ingressos emitidos (a lista de participantes) do evento, na ordem de emissão.
- [Buscar ingresso](https://ingressoja.com/docs#get-ticket): `GET /events/{id}/tickets/{code}` Um ingresso pelo código (o mesmo conteúdo do QR code).
- [Fazer check-in](https://ingressoja.com/docs#check-in): `POST /events/{id}/tickets/{code}/check-in` Valida o ingresso na entrada (catraca, totem, app próprio).
- [Webhooks de eventos](https://ingressoja.com/docs#webhooks): order.paid, order.refunded, order.cancelled, ticket.checked_in, event.updated

## API de pagamentos (PIX)

- [Gerar PIX](https://ingressoja.com/docs#gateway-pix): `POST /gateway/pix/receive` Gera uma cobrança PIX em nome da sua conta: devolve o copia e cola e o QR code para você mostrar ao pagador.
- [Consultar transação](https://ingressoja.com/docs#gateway-consulta): `GET /transactions` A situação de uma cobrança pelo id (transactionId) ou pelo identifier que você enviou.
- [Cadastrar webhook](https://ingressoja.com/docs#gateway-webhook-criar): `POST /webhooks` Um endereço que recebe os avisos de todas as cobranças da conta (sem precisar mandar callbackUrl em cada PIX).
- [Listar webhooks](https://ingressoja.com/docs#gateway-webhook-listar): `GET /webhooks` Os webhooks de pagamento cadastrados na sua conta.
- [Remover webhook](https://ingressoja.com/docs#gateway-webhook-apagar): `DELETE /webhooks` Remove um webhook de pagamento da sua conta.
- [Avisos de pagamento](https://ingressoja.com/docs#avisos-pagamento): TRANSACTION_PAID, TRANSACTION_CANCELED, TRANSACTION_REFUNDED, TRANSACTION_CHARGED_BACK, assinados com HMAC-SHA256

## Opcional

- [Central de ajuda](https://ingressoja.com/ajuda)
- Suporte: contato@ingressoja.com