Skip to main content
Estado do Cliente é um conceito que permite consultar o estado atual de um cliente, incluindo suas assinaturas ativas e benefícios,concedidos, em uma única chamada de API ou único evento de webhook. Combinado com o recurso de ID Externo, você pode começar em poucos minutos.

O objeto de estado do cliente

O objeto de estado do cliente contém:
  • Todos os dados sobre o cliente.
  • A lista de suas assinaturas ativas.
  • A lista de seus benefícios concedidos.
  • A lista de seus medidores ativos, com o saldo atual.
Assim, com esse único objeto, você tem todas as informações necessárias para verificar se deve ou não provisionar acesso ao seu serviço.

Get Customer State by External ID

Um único endpoint para controlar tudo, usando o seu próprio ID de cliente.

Get Customer State

O mesmo endpoint, mas com o ID interno do cliente da Norbaas.

O webhook customer.state_changed

Para ser notificado sobre mudanças no estado do cliente, você pode escutar o evento de webhook customer.state_changed. Ele é acionado quando:
  • Um cliente é criado, atualizado ou excluído.
  • Uma assinatura é criada ou atualizada.
  • Um benefício é concedido ou revogado.
Ao assinar esse evento de webhook, você mantém seu sistema atualizado e ajusta o acesso do seu cliente conforme necessário.

customer.state_changed

Um único webhook para controlar tudo.