Verificar novamente uma marca de mensagens

Conferir novamente a identidade empresarial corrigida

Use esta operação quando for necessário conferir novamente os dados de identidade corrigidos de uma marca existente de uma organização. Primeiro, atualize a marca existente, depois consulte o status atual de identidade. Uma atualização comum do perfil não envia esta tentativa paga separadamente. A nova verificação não cria outra marca nem registra uma campanha.

Use sua própria conta de API habilitada por meio de HTTPS, a partir de um IP de origem permitido. A marca deve pertencer a essa conta. Mantenha os registros das marcas privados: eles contêm informações empresariais e de contato.

Revisar a marca antes do envio

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
  --output current-brand.json

Confira se a marca retornada corresponde à empresa pretendida e se a correção está presente. Se o registro original estiver pendente, ainda não será possível realizar uma nova verificação. O registro pode rejeitar uma solicitação quando as informações empresariais não tiverem mudado. A ausência de atributos especiais pode exigir um recurso em vez de outra verificação de identidade. As marcas de empresários individuais usam o fluxo de identidade/PIN apropriado; não trate este endpoint como um substituto.

Confirmar a cobrança separada

A tarifa de nova verificação atualmente configurada para produção é de US$5.00 por tentativa aceita, conferida em 24 de outubro de 2026. É aplicada a tarifa padrão de marca, inclusive quando a entidade original tem um preço de registro diferente. As compras devem estar habilitadas; contas pré-pagas precisam de saldo suficiente antes do envio.

Uma resposta 202 significa que a solicitação foi aceita para processamento adicional, e a cobrança é encaminhada no momento da aceitação. Isso não significa que a empresa esteja verificada. Uma nova tentativa posterior pode gerar outra cobrança. Não crie uma nova tentativa apenas porque a verificação continua pendente.

Enviar uma única tentativa deliberada

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"

Não é necessário enviar um corpo com o perfil: esta operação verifica os dados da marca já armazenados. Use uma chave de idempotência exclusiva para a tentativa pretendida e mantenha exatamente o mesmo método, caminho, consulta e corpo nas repetições. As chaves aceitam 1–128 caracteres ASCII imprimíveis, sem espaços. Uma duplicata de uma tentativa em andamento pode retornar 409 com Retry-After; uma tentativa concluída pode retornar novamente seu resultado salvo, inclusive um erro.

A API pública também aceita autenticação Bearer para uma conta com autenticação por token habilitada. As verificações de titularidade da conta e de IP de origem permitido continuam sendo aplicadas. As marcas simuladas armazenadas não passam por este fluxo de cobrança de produção, mas um resultado do ambiente de testes não constitui uma verificação de identidade em produção.

Consultar o resultado e acompanhar seu status

O proxy atualiza seu registro local da marca após uma alteração aceita; essa atualização, por si só, não comprova um resultado final da verificação. Uma empresa pode continuar não verificada ou pendente. Antes de prosseguir com a configuração da campanha, consulte o status atual da marca em vez de se basear apenas na aceitação HTTP.

Recuperar um resultado incerto

Uma falha de transporte pode gerar uma resposta 502 armazenada em cache. Uma solicitação aceita pelo serviço de destino, seguida de uma falha local de persistência ou faturamento, pode gerar uma resposta 500 armazenada em cache com requestId. Preserve esse identificador e concilie com o suporte o estado atual da marca e do faturamento. Gerar outra chave pode criar uma tentativa cobrada separadamente; não repita a solicitação às cegas com uma nova chave.

Uso do portal do cliente

O portal oferece uma nova verificação para uma organização em produção com status UNVERIFIED, após a revisão do perfil e da cobrança atuais. Ele verifica se o perfil e o preço não mudaram e rejeita outro envio aceito para os mesmos dados atuais. As marcas do ambiente de testes e de empresários individuais estão excluídas desta ação do portal.

Essas proteções do portal são verificações adicionais do fluxo de trabalho. Os clientes que usam diretamente a API devem realizar sua própria revisão e não devem presumir que a API exige os campos de versão ou de confirmação de preço do portal. Salvar uma correção comum da marca é uma ação separada e não envia automaticamente uma solicitação de nova verificação.