# TicketingHub para programadores.

Integre o widget de reservas, crie o seu próprio checkout com a Widget API ou ligue os seus sistemas com as Supplier APIs e os webhooks, com cada endpoint na [documentação para programadores](https://api.ticketinghub.com/api-docs/index.html).

- [Widget de reservas](https://www.ticketinghub.com/pt/developers#widget)
- [Widget API](https://www.ticketinghub.com/pt/developers#widget-api)
- [Supplier APIs e webhooks](https://www.ticketinghub.com/pt/developers#apis-webhooks)
- [Passos para o lançamento](https://www.ticketinghub.com/pt/developers#launch)

## Integre o widget de reservas no seu site.

Este é o widget ao vivo em que os seus clientes reservam: adicione um bilhete para experimentar.

- **Integre o widget.** Adicione-o ao seu site com um pequeno snippet e teste-o antes de o publicar.

- **Use as suas próprias cores.** Um checkout alojado com as suas cores, no seu próprio site.

- **Receba pagamentos através do TicketingHub.** A disponibilidade, o pagamento e a confirmação ficam no TicketingHub.

Conheça a [venda online](https://www.ticketinghub.com/pt/product/sell#online) com o widget de reservas.

[Veja o widget ao vivo no site da Immersive Gamebox](https://www.immersivegamebox.com/en-US)

Ao vivo – experimente

## Crie o seu próprio checkout com a Widget API.

O seu checkout obtém a disponibilidade da API e confirma a reserva depois do pagamento.

- **Obtenha a disponibilidade.** Consulte as datas e horas que um cliente pode reservar.

- **Crie o cesto.** Adicione os bilhetes e os dados do cliente à encomenda.

- **Guarde as credenciais no seu servidor.** Os pedidos passam pelo seu servidor, e a sua integração cobra o pagamento antes de confirmar a encomenda.

Consulte a [referência da Widget API](https://api.ticketinghub.com/api-docs/index.html?urls.primaryName=Widget%20API%20V1).

*Ilustração: o seu próprio checkout obtém a disponibilidade pela API, o cliente escolhe um horário e a reserva é confirmada pela API.*

## Ligue os seus sistemas com as Supplier APIs e os webhooks.

Cada nova reserva é enviada para as suas ferramentas, e para o seu próprio sistema como um webhook assinado.

- **Trabalhe com a sua conta.** As Supplier APIs gerem produtos, reservas e operações a partir dos seus próprios sistemas.

- **Receba webhooks assinados.** Receba uma notificação quando uma reserva é confirmada, cancelada ou atualizada.

- **Verifique e repita.** Verifique cada assinatura no seu servidor; a documentação explica os payloads e as novas tentativas.

Consulte a [referência das Supplier APIs](https://api.ticketinghub.com/api-docs/index.html?urls.primaryName=Supplier%20API%20V2) e os [webhooks](https://api.ticketinghub.com/api-docs/index.html?urls.primaryName=Webhooks).

*Ilustração: uma nova reserva online é enviada, uma de cada vez, a cada uma das suas ferramentas conectadas.*

## Do primeiro pedido ao lançamento.

1. **Diga-nos o que está a construir.** Partilhe o seu fluxo de reserva, os sistemas que quer ligar e os dados de que precisa.

2. **Confirme o seu acesso.** Combine com a nossa equipa o acesso à API e a configuração de que a sua integração precisa.

3. **Construa e teste.** Use a referência da API para explorar endpoints, verificar formatos de pedido e testar o seu fluxo de reserva.

4. **Prepare o lançamento.** Verifique o tratamento de pagamentos, as respostas de erro e os webhooks que a sua integração usa.

## Perguntas frequentes.

### Vocês oferecem chaves de API públicas e de autoatendimento?

Habilitamos o acesso à API após uma breve conversa sobre seu caso de uso para que possamos direcioná-lo para as superfícies e ambientes corretos. Agende uma demonstração para começar.

### Qual é a diferença entre a API de Widget e as APIs de Fornecedores?

A API do Widget ajuda você a construir fluxos orientados por servidor em torno do nosso checkout incorporável. As APIs de Fornecedor são para gerenciar produtos, reservas e operações programaticamente. Muitas equipes usam ambos.

### Como faço para testar antes da produção?

Fornecemos credenciais e documentação apropriadas para o ambiente para que você possa validar integrações com segurança. Seu contato na TicketingHub confirmará quais endpoints usar enquanto você desenvolve.

### Como os webhooks são autenticados?

Webhooks são entregues via HTTPS e incluem assinaturas que você deve verificar no seu servidor. Trate o segredo de assinatura como qualquer outra credencial—armazene-o apenas no lado do servidor.

### Posso obter ajuda com a implementação?

Sim. Nossa equipe apoia os parceiros durante a integração, casos especiais e revisões de lançamento—especialmente quando você está conectando pagamentos, controle de acesso ou relatórios personalizados.