Utilice una marca de mensajería que pertenezca a la cuenta
Utilice una cuenta API habilitada mediante HTTPS desde una dirección IP de origen permitida. Se admite la autenticación Basic y Bearer. El ID de la marca debe pertenecer a esa cuenta. Mantenga en privado los tokens del proveedor, los datos de identidad de la marca y los informes recibidos.
Solicite una nueva comprobación externa
Utilice POST cuando necesite que un proveedor de evaluación realice una nueva comprobación de esta marca. Si ya dispone de un resultado del proveedor, utilice la importación en su lugar. Esta operación es independiente de la nueva verificación de la identidad de la marca.
Consulte primero la marca actual y confirme sus datos de identidad. Seleccione una combinación de proveedor y clase admitida en los catálogos actuales y compruebe los requisitos de ese proveedor. No todos los proveedores admiten todas las clases. Los datos adicionales de la evaluación política deben describir la organización o campaña real, no ser datos de ejemplo.
Prepare la solicitud al proveedor
| Campo | Valor |
|---|---|
| evpId | ID obligatorio del proveedor, tomado del catálogo actual de proveedores de evaluación externa, de 1–10 caracteres. |
| vettingClass | La clase admitida que desea adquirir; selecciónela explícitamente y confirme su precio. |
| additionalRequestPayload | Una cadena codificada en JSON con datos específicos del proveedor, obligatoria para la evaluación política. Es una cadena dentro del objeto JSON externo, no un objeto anidado. Confirme todos los datos obligatorios con el proveedor seleccionado. |
Confirme los cargos por éxito y por fallo
Tarifas minoristas actuales en dólares estadounidenses, consultadas el 24 de octubre de 2026. Confirme el importe vigente antes de realizar una solicitud real. Se comprueba que el saldo de prepago cubra el precio por éxito; las compras deben estar habilitadas.
| Clase | Resultado activo | Resultado fallido |
|---|---|---|
| STANDARD | $46.12 | $5.56 |
| ENHANCED | $112.78 | $6.67 |
| POLITICAL | $73.34 | $24.45 |
| POLITICAL con solicitud Express | $106.67 | $24.45 |
| AUTHPLUS | $13.89 | $13.89 |
| RCS | $83.34 | $83.34 |
Las solicitudes pendientes conservan sus importes por éxito y por fallo y se liquidan cuando se sincroniza un resultado ACTIVE o FAILED. Las dos últimas clases utilizan la misma tarifa configurada para cualquiera de los dos resultados finales. Un resultado final inmediato puede generar un cargo durante la respuesta a la solicitud. Una sincronización posterior del estado puede liquidar un cargo pendiente.
No utilice mock:true como garantía de una evaluación externa gratuita. El proceso actual de liquidación de evaluaciones externas puede aun así registrar y cobrar esa solicitud. Estas instrucciones no requieren una compra real para realizar pruebas; utilice datos de prueba sin conexión hasta que tenga intención de autorizar una comprobación de pago.
Envíe una única solicitud revisada
Prepare vetting-order.json con el ID del proveedor, la clase y toda la información adicional obligatoria. El archivo contiene la solicitud real que desea realizar. Manténgalo en privado.
curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
--request POST \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @vetting-order.json \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID/externalVetting"Haga seguimiento del resultado real
Una respuesta HTTP satisfactoria puede contener un registro de evaluación pendiente. Conserve su vettingId y consulte vettingStatus, los motivos, la puntuación y las fechas de entrada en vigor y vencimiento cuando estén disponibles. PENDING y UNSCORE requieren seguimiento adicional; ACTIVE, FAILED y EXPIRED describen resultados distintos. La aceptación HTTP por sí sola no demuestra una puntuación favorable ni la elegibilidad de la campaña.
Utilice el estado de la evaluación externa para hacer seguimiento del registro. Consultar o importar un resultado final puede liquidar una solicitud de pago anterior; no implica necesariamente quedar exento de un cargo pendiente ya existente.
Reintente la misma solicitud prevista
Utilice una Idempotency-Key por cada operación prevista y conserve exactamente el método, la ruta, la consulta y los bytes del cuerpo. Las claves admiten 1–128 caracteres ASCII imprimibles sin espacios. Una solicitud duplicada cuya operación siga en curso puede devolver 409 con Retry-After. Las solicitudes completadas vuelven a devolver su respuesta almacenada, incluidos los errores. Respete los límites de frecuencia.
Un fallo de transporte puede dar lugar a un 502 almacenado en caché. Un 500 almacenado en caché con requestId puede significar que el registro aceptó la operación, pero falló la persistencia local o la facturación. Conserve el ID de la solicitud, consulte los registros actuales y aclare y concilie la situación con el equipo de soporte antes de utilizar una clave nueva. No suponga que el error significa que no existe ninguna solicitud.