Developers

Documentação técnica da nossa API e webhooks — só o que existe de verdade, hoje.

Ainda não existe uma API pública de dados (eventos, pedidos, ingressos) para integradores externos consumirem. O único endpoint real disponível hoje é o webhook de pagamento abaixo.

Webhook de pagamento (inbound)

Endpoint que a IngressoWay expõe pra receber notificações de um provedor de pagamento sobre o status de uma tentativa de pagamento. Hoje não há nenhum provedor real conectado — o endpoint funciona de ponta a ponta, mas só recebe tráfego do nosso próprio simulador de demonstração.

Método e caminho: POST /api/webhooks/payment
Autenticação: Assinatura HMAC-SHA256 do corpo bruto da requisição, enviada no header x-ingressoway-signature. A assinatura é verificada em tempo constante contra o segredo configurado no servidor.
Corpo da requisição (JSON): { "externalId": "string", "type": "payment.approved" | "payment.pending" | "payment.expired" | "payment.failed", "paymentAttemptId": "string", "data": { } }
Respostas: 200 com { ok: true, processed: boolean } em sucesso; 401 se a assinatura for inválida; 400 se o payload for inválido; 500 se o processamento falhar (sinaliza pro provedor tentar de novo).
Idempotência: Deduplicado por (provider, externalId) — reenviar o mesmo evento nunca processa duas vezes.

API pública de dados (eventos, pedidos, ingressos)

Ainda não implementada. Quando existir, esta página vai listar os endpoints reais disponíveis — nunca antes disso.