Ao fazer integrações com a TipsterTrade você talvez tenha o interesse de utilizar webhooks. Webhooks é uma forma da TipsterTrade informar para um servidor externo sobre alterações e eventos relacionados a conta, assinaturas e cobranças.
Para criar um WebHook, acesse sua conta, procure o menu na lateral chamado API e crie um novo webhook informando uma URL e os eventos que tem interesse, a lista de eventos apresenta uma breve descrição do evento e um exemplo de dado enviado quando ele ocorre.
Seu servidor ao receber o webhook deve responder com um status de sucesso (200 ou 2xx).
Por padrão é feito 10 tentativas de envio do webhook caso o servidor não responda com um status de sucesso, a resposta para o webhook deve ser respondida em até 55 segundos, caso contrário consideramos que a solicitação falhou e uma nova tentativa será criada.
A cada nova tentativa o tempo entre as tentativas aumenta, seguindo a seguinte ordem:
- 1 minuto
- 5 minutos
- 30 minutos
- 1 hora
- 5 horas
- 10 horas
- 24 horas
- 48 horas
- 72 horas
Tentamos enviar os webhooks em ordem (exemplo: assinatura criada -> cobrança criada), porém sua aplicação não deve considerar que sempre eles chegaram em ordem.
Todo webhook possui um ID que pode ser armazenado no seu sistema e que pode ser verificado ao receber um webhook se o mesmo já foi recebido e processado.
Você também pode utilizar a API REST para outros casos.