Use uma marca de mensagens que pertença à conta
Use uma conta de API habilitada por meio de HTTPS, a partir de um endereço IP de origem permitido. São aceitos os métodos de autenticação Basic e Bearer. O identificador da marca deve pertencer a essa conta. Mantenha em sigilo os tokens do provedor, os dados de identidade da marca e os relatórios retornados.
Use um resultado existente do provedor
Use PUT para associar à sua marca um resultado de avaliação existente de um provedor compatível. Essa operação não solicita uma nova avaliação. Obtenha o identificador correto da transação do provedor e qualquer token de confirmação necessário diretamente desse provedor, e certifique-se de que o relatório corresponda à mesma identidade empresarial.
AUTHPLUS não oferece suporte a esse fluxo de importação. As regras de correspondência específicas do provedor continuam válidas; uma solicitação de importação não dispensa o cumprimento dessas regras nem garante a elegibilidade para todos os casos de uso de campanhas.
Prepare a importação
| Campo | Valor |
|---|---|
| evpId | Identificador de um provedor compatível, com 1–10 caracteres. |
| vettingId | O identificador real da transação de avaliação do provedor, com até 255 caracteres. Não o substitua pelo identificador da marca nem invente um identificador. |
| vettingToken | Token de confirmação quando exigido pelo provedor, com até 65535 caracteres. Trate-o como um segredo e omita-o quando o provedor não o exigir. |
Crie vetting-import.json com os valores reais do provedor. Não envie campos de pontuação, estado ou data e hora exclusivos da resposta como se pudessem alterar o resultado.
Importe o resultado uma única vez
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request PUT \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-import.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Entenda as cobranças existentes
Este proxy não registra um resultado recém-importado como um novo pedido pago. Isso não cancela uma avaliação solicitada anteriormente: quando o mesmo vettingId já tem um pedido aguardando resultado ou com cobrança pendente, importar um resultado ACTIVE ou FAILED pode liquidar a tarifa registrada nesse pedido. Este ramo de sincronização não cobra novamente um registro que já tenha sido cobrado.
Acompanhe o resultado real
Uma resposta HTTP bem-sucedida pode conter um registro de avaliação pendente. Guarde o vettingId desse registro e consulte vettingStatus, os motivos, a pontuação e as datas de início de vigência e expiração, conforme disponíveis. PENDING e UNSCORE exigem acompanhamento adicional; ACTIVE, FAILED e EXPIRED descrevem resultados diferentes. A aceitação no nível de HTTP, por si só, não comprova uma pontuação favorável nem a elegibilidade para campanhas.
Use estado da avaliação externa para acompanhar o registro. Consultar ou importar um resultado final pode liquidar um pedido pago anterior; isso não implica necessariamente a ausência de uma cobrança já pendente.
Tente novamente a mesma solicitação pretendida
Use uma Idempotency-Key para cada operação pretendida e preserve exatamente o método, o caminho, a consulta e os bytes do corpo. As chaves aceitam 1–128 caracteres ASCII imprimíveis, sem espaços. Uma solicitação duplicada enquanto a original ainda está em andamento pode retornar 409 com Retry-After. As solicitações concluídas retornam novamente a resposta armazenada, incluindo erros. Respeite os limites de frequência de solicitações.
Uma falha de transporte pode resultar em um 502 armazenado em cache. Um 500 armazenado em cache com requestId pode significar que o registro aceitou a operação, mas houve uma falha no armazenamento local ou no faturamento. Guarde o identificador da solicitação, consulte os registros atuais e resolva as divergências com a equipe de suporte antes de usar uma nova chave. Não presuma que o erro significa que não existe nenhum pedido.