Automatize com clareza.

Comece no seu servidor

Guarde credenciais de integração somente no servidor da sua aplicação. Nunca inclua segredos em páginas, aplicativos distribuídos ou URLs. A documentação pública usa exclusivamente exemplos fictícios.

A referência informa o esquema de autenticação, os campos obrigatórios, as permissões e os erros de cada operação. A sessão da área do revendedor não substitui a autenticação de integração.

Clientes, saldo e ativações

Consulte o saldo e identifique clientes pelo ID e pelo código temporário autorizado. Ativações para 1, 3, 6 ou 12 meses devem confirmar período e débito de créditos. Use a chave de idempotência definida no contrato para evitar uma segunda cobrança ao repetir uma solicitação.

A disponibilização depende da API habilitada e das permissões da revenda. Uma resposta de erro não deve ser tratada como confirmação de ativação.

Gerenciamento de listas

Cadastro, edição, exclusão, teste, sincronização e consulta de status são operações diferentes. Sincronizações podem ocorrer em segundo plano: acompanhe o status antes de anunciar que a biblioteca está pronta.

Envie apenas fontes autorizadas. URLs e credenciais de provedores não devem aparecer em logs de atendimento ou mensagens ao cliente.

Renovação e webhooks

A renovação automática é uma escolha explícita. Consulte o estado atual e a operação de cancelamento; desativar renovação não equivale a apagar o acesso já concedido.

Receba eventos no seu servidor. Verifique assinatura e validade conforme o contrato, deduplique eventos e aceite tentativas repetidas. Não confie apenas no nome do evento recebido.

Contrato e exemplos

Valores monetários, períodos, limites, erros e assinatura de eventos devem seguir a especificação publicada. As chamadas demonstrativas não acessam contas reais por esta página.